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1.0 PREFACE 


This document is intended to contain the information 
necessary for use of the NOS 170 prototype version of SCU by a 
terminal or batch user. Since there are some features which 
are of necessity operating system or machine dependent and 


because not ail features which wilttl -appear in the NOS/VE 


impiementation will be present in the prototyoe these two 
implementations are being described in separate documents. 
The revision bars shown in this document have been generated 
relative to the ERS For Source Code Utitity DCS number ARH1766 
revision Ge That was the fast ERS submitted to BCS which 
attemoted to describe both imolementations.e An ERS describing 


the NOS/VE version of the utitity wit be submitted to obCS 


under another number. 


1o2 APPLICABLE DOCUMENTS 


iment _ ‘DCS_Number 
SES User's Handbook ARH1833 
NOS Reference Manual 
NOS/VE ERS =~ Command Interface ARH3609 


CYBER 180 System Interface Standard $2196 
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2-0 INTRODUCTION 


200 INTRODUCTION 


The purpose of this document is to describe the NOS 170 
prototype version of a utility which wiit orovide for 
introduction and maintenance of ASCII source data on the Cyber 
180. White emphasis is placed on the contro} and 
documentation necessary in tiarge development groups, it can be 
used by individuats maintaining private source libraries. 


The utitity described betow inctudes an interactive editor 
alfowing for interactive development of new source units or 
corrections to existing source units. [tf provides muiti_deck 
and buitd capabilities, aliows for grouping of source decks 
and correction sets into targer éidentifiabte units and 
associates descriptive information with source decks and 
correction sets. 


The commands described in this document make use of the 
System Command tLanguage (SCL) syntax which has been defined 
for NOS/VE,. the operating system that will execute on Cyber 
180. . 


This document describes the implementation of this utility 
on NOS 170... The reader should be aware that some of the 
parameters described below are machine dependent and wilt 
require adjustment when the final version of this utility is 
implemented to execute under NOS/VE. The most common examples 
of parameter information that wil i change is the itength of 
user names and file names. Where possibie the NOS 170 version 
will be made to emulate the final environment. 


Zei CONCEPTS 


This section introduces terms used throughout tater 
sections of this document. 


Z2eiei SOURCE LIBRARY 


A source tibrary is ae fite containing a collecticn of 
source decks. A source tibrary wilt usuatty represent alto or 
part of the source code for a product at a certain stace of 
development. 
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2eie2 SOURCE DECK 


A source deck is a physical collection of lines of source 
texte The text may consist of source code, documentation or 
any other type of source datae SCU text embedded directives 
may be intermixed with the source datae Each fine of text 
will have associated with it a unique (with respect to the 
deck) fine identifier which can be used to identify the tine. 
A line identifier consists of an alphanumeric modification 
name and a sequence number relative to that modification as if 
appiies to a given decke 


A group is a name associated with a cotilection of decks to 
allow for the togicatly retated dacks to be extracted from a 
source tibrary together or merety to document the fact that 
they are togicalfiy reiated. A deck may have up to 255 group 
names assoctated with ite 


2eie& MODIFICATION 


In this document the term modification wit! be used to mean 
the changes introduced to a deck or series of decks by an edit 
session. It is possibie to have an edit session be consicered 
a continuation of a previous one. Each modification has 
associated with if a unique user assigned name. This name 
will be used to form the tine identifier of each source tine 
introduced by the modification. 

Modifications are stored on the source tibrary by SCU in 
terms of their effect on the source decks to which they apply, 
rather than in the form of the origina! commands that 
introduced the change. 


2eieS FEATURE 


A feature is a name associated with a modification. 
Associating the same feature name with several modifications 
to the same or different decks allows one the ability to group 
modifications together to be appftied or ignored as a groupe 
For exampie alf the modifications necessary to make a major 
change in an interactive interface to the system could be 
associated with a common feature namee A modification may 
have only one feature name associated with it. 
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20126 STATES 


Every modification has a specific state assigned to ite 
The state refiects the degree of maturity the modification nas 
attained. The following states are defined? 


0 ~- Experimental Untested code. This imcties that this 
shoutd probably not be included in a 
tuiid by anyone exceot the persor 
actually working on it or someone 


wanting to check for a potential 
conflicte 

1 - Developmental Code which has been unit tested. 

2 ~- Stable Code which has passed regression testse« 

3 = Verified Code which has been found to perform as 
zedvertised. 

& - Released Code which has been completety tested 


end approved. 


A modification in state 0 may nave its text or descriptive 
information aitered. Aliso if the user has proper authoritys 
he can raise the state of a state 0 modificatione 


Modifications in states 1, 2 or 3 may onty be raised In 
state or towered to state O06. No aiteration of texf or 
descrinvtive information is aliowed for modifications in these 
states. 


A modification in state 4& cannot he aitered in text, 
description or state. In other words, errors in text tines 
introduced by a state & modification must be corrected under 
another modification name. 


2ele? AUTHORITY 


In this document the term authority will be used to mean a 
user name that is vatidated by SCU to perform certain 
maniputations on a source tibrbary. A source fiibrary has 
associated with it a specification of each of four authorities 
necessary to change the state of a modification. The 
authorities specified are for 1 - Deveiopmental, 2 - Stable, 3 
~ Verified and & - Released. Each modification has a 
specified state which may inctude any of the above or 9 - 
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Experimentai. A user must nave the specified authority for a 
library (or a higher one) to raise the state of a modification 
to a given fevel or to tower it from that state to state 0. 


201.28 CRITERIA FILE 


A criteria fite contains directives used to timit which 
features and modifications at which states are to be included 
when bliocks of source data are expanded from a source 
{ibrary. Similarty decks or groups may be incfuded or 
excluded through directives on a criteria filtee In addition 
values may be dectiared in a criteria file which can be used to 
trigger conditional inctusion of blocks of source data when 

decks are extracted from a source library and expanded for a 
processor. 


201293 TEXT EMBEDDED DIRECTIVES 


When a user wishes to prepare source data for a processor, 
SCU will expand the source under the control of text embedded 
directives some of which interact with the contents of a 
criteria file. Text embedded directives are intermixed with 
the source datae Text embedded directives are recognized as 
distinct from source data by the occurrence of a specific 
character in the first oostion on the iine followed 
immediatety by a keyword. In this document asterisk is shown 
as the key character in ali examples. Some examopites of text 
embedded directives are *COPY and *ELSE. 


201210 NORMAL SEARCH ORDER 


Some SCU commands working with decks allow the use of 
mulfipote source libraries. In tocating a deck, the source 
fibraries are searched in the order in which they are given in 
the ftist. 


2e1211 BASIC STATUS CONCEPTS 


System Command Language (SCL) under NOS/VE will require aft. 
commands to have a status parameter. This oarameter will be 
used to try to standardize the processing of error messages 
and abnormal responses from command processors. In the 
version of this utility which is impiemented to execute under 
NOS on CYBER 170 systems the value of this parameter must be 
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given as the name of one cf the job 


2-5 


83/24/80 
REV3 J 


regeisters, Ri, 


R2, R3 or EF. The named register will be set non-zero if an 


error is encountered while processing a command. 


R3 is givens the vatue 


correspond to the condition codes 


messagese 


2elei2 NAMES 


Names used in SCU will 


If Ri, R2 or 


register wilt 
the section on 


fotiow the NOS/VE patterns. Valid 


characters to be inciuded in a name are upper and flower case 


letters, the characters “#", 
decimal digits. Names must not begin with a 


{undertine) and 
Gigit. Library 


names, deck names, feature names and group names will contain 


1 to 34 characters. The onty exceptions to the 


pattern will 


be modification names which wilt be restricted to a maximum of 
9 characters in length. Modification sequence numbers wit! be 


6 digits tong and range from 1 to 262143. 


2eiei3 STRINGS 


Some parameters for the SCU commands are described as being 
strings. System Command Language syntax requires strings to 


be enctosed in singte quotes. 


2e1-14% LOCAL FILES 


SCU assumes all files it is to deal 
exception of those named on the 
below. The user may specify 


files, if different than his 


second vaiue in a value sefe 


to acquire access to other 
commands to use them. 


files oprior 


with are tocal with the 
RESULT parameters 
user name for permanent 

including it as the 
It is tne user‘s responsibility 
initiating sScu 


The NOS 42170 version of SCU uses a series of scratch files 


internally whose names begin with 


*SESSC*. The 


user of the NOS 170 version shoutd avoid making explicit use 


of files with names fitting this pattern. 
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320 COMMANDS 


The commands tisted betow are availtabie in the SCu 
environment. Commands for the editor, text embedded 
directives and criteria file directives are described later. 
The commands tisted here function as separate jobd controt 
statements and are intended to use a syntax aS simitar as 
possibie to that of the System Command Language (SCL) for 


NOS/VE. When accessed on NOS 170< these commands must be 
pretixed by the characters “scue". The commands can aitso be 


bound together in a more intimate fashion as described tetow 
under command grouping. 


Parameter defaults are assigned as _ fotflows. Required 
parameters where possibie will nave static defautts assigned 
initially such as Bm8eE for the name of the base source 
fibrary. The commands tisted here are presented in a manner 
so as to emphasize the parameters of the commands. Optionat 
parameters are enclosed with square brackets. AS with NCS/VE 
SCL commandss commas and/or spaces can be used to Separate 
parameters. Parameters can be given positionally,. by 
keyword=value or amixturee In the tatter case specification 
of a parameter by keyword “resets” the positional pointer to 
the following parameter § fietd. Where avaitabte, shortened 
forms for the keywords are shown. An eltipsis (two or  ~*more 
periods) at the end of a tine indicate that the command is 
being continued on the next tine. __NOS. 170 lower case 
letters apsoearing in strings on the first physical fine of an 
SCU_ command will be capitalizede To avoid this. unpleasant 
Side affect of executing on NOS 170 a user should include 
strings which are parameters to SCY on continuation liness_ 


As on NOS/VE att ‘tower case ietters appearing inside names 
{and references to nemes) are transtated to their upper case 
counteroarts by the SCL interpreter. 


The short form of each command is tisted with the command. 
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3e1 SOURCE LIBRARIES 


The fotlowing commands are availabie for creating and 
manipulating source li traries. 


3eiei CREATE_LIBRARY ¢ CRL 


This command creates the header of a source !ibrary on = the 
specified file and inctudes in this header the descriptive 
information about the tibrary inctuding the tibrary name, key 
character for text embedded directives and user names to be 
assigned authorities. 


create _ftibrary (name=<library_name>i 

{description=<descriptive_string>] 

' fauthor it y_1=<user_name>] 
tauthor it y_2=<user_name>] 
Tauthor it y_3=<user_name>] 
Tauthority_4=<user_name>] 
[key=<char>] . 
(version=<version_string>] 
(result =<file_name>]} 
(status=riir2ir3ief } 


name %? na 3: This specifies the name of the soutce 
fibrary. If this parameter is omitted the name of the 
result file will be used. 


description ! de ?: This 1 to 256 character string is used 
to describe the source code maintained on this tibrary. 


authority_1 3 a1 32 This is the 7 character user name to 
have authority 1 (developmental authority) for this 
library. If parameters authority_1 through authority_4& 
are not givens the user name that the command is 
executing under will be usede 


authority_2 3 a2 3 This is the 7 character user name toa 


have authority 2 (stabie authority) for this ftibrary. 


authority_3$ i a3 % This is the 7 character user name to 
have authority 3 (verified authority) over this tibrarye 


authority_4 ¢ a& %: This is the 7 character user name to 
nave authority 4& (released authority) for this tibrarye 
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COMMANDS 
ei CREATE_LIBRARY 7? CRL 


key 7 k 3 This one character string specifies the key 
character used to fiag text embedded directives on this 
source tibrary. This defaults to *. 


version {! ve : This 1 to 31 character string is used to 
give a version number for the tibrary. 


result tr This is the name of the fite on which the 
source tibrary is to be createde RESULT is used as a 
default vaiue. 


status ! st 3: See basic status concept. 


Exampiess’ 
scuecreate_tibdrary scu_source_code “Neat stuf f.* ak=mjn2523 .< 
r=scupi 


SCU.CRL Tabie_Tennis_Leaque_Records 


In the first exampie the tiibrary name and description 
parameters are given positionaitiy and the authority_& and 
result file names are given with the keyword = value syntaxe 
The remaining authorities woutd default to tne user name the 
command was executed under and * would be used to flag text 
embedded directives. 

In the second example onty the tfibrary name is civen 
explicitty and a source library wilt be created on the _§ fite 
RESULT. 
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Seie2 BDISPLAY_LIBRARY % Dit 


This command tists the descriptive information stored in 
the source tibrary header and optionally the contents of deck, 
group, modification and feature tists for tne tibrarye 


display_ltibrary Ibase=<file_name>} 
Liist=<tocat_file_ name>] 
{brief 2 fault] 
(status=riir2ir3ief) 


base 1 ba ?: This is the name of the file containing the 
base source {jibrary. If this parameter is not .siven an 
attempt is made to access a file with the name BASE. 


list 3 1 : This is the name of the file which receives 
the fisting. If this parameter is not given, the  fite 
name OUTPUT wili be used. 


brief 7 br 3 full ; fu 3 If the command contains the 
keyword BRIEF, only the information from the tibrary 
header wiiti be displayed. If the keyword FULL is 


present, the deck, group, modification and feature iists 


for the library witli be disolayed as welt. [f neither is 
present BRIEF is assumed. 


status i st 3 See basic status concept. 


Exampies 
scuedisotay_tibrary ba = oldpt 


This command wilt dispiay onty the descriptive information 


from the fibrary header of the source tibrary on fife OLDPL. 
The disptay wilt be written to the file OUTPUT. 
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3eie3 CHANGE_LIBRARY ? CHL 5 | 
2 

This command altows a user to aiter fietds in the tibrary 3 
description. & 
5 

change_tibrary (name=<tibrary_name>] 6 
tidescriotion=<descriptive_string>] % 

Tauthor it y_1=<user_ name>] 8 

Cauthor it y_2=<user_name>] | 

fauthor it y_3=<user_name>] 10 
Cauthority_4=<user_name> ] if 
{version=<version_string>] 12 
{base=<fite_name>] | 713 

fresult t=<fite_name>i 714 
{status=riir2ir3ief] 15 

16 

name ? na °: This specifies the name of the source 17 
fibrary. : 18 
19 

description i de 3: This 1 to 256 character string is used 26 
to describe the source code maintained on this tibrary. 2t 
22 

authority_i ¢ ai: This is the 7 character user name to 23 
have authority 1 for this tibrary. In order to aiter 24 
fietds authority_1i through authority 4, this command must 25 
be executed under the user name that has the 25 
corresponding authority or a higher onee 2? 
28 

authority_2 3 a2 3: This is the 7 character user name to 29 
have authority 2 over this ftibrary. 38 
3fi 

authority_3 1 a3 3: This is the 7 character,user name to 32 
have authority 3 over this tibrary. 33 
3% 

authority_4& ! a& 3: This is the 7 character user name to 35 
have authority & for this tibrary. 35 
37 

version ? ve 3 This 1 to 314 character string is used to 738 
give a version number for the source library. 139 
4&0 

base ! ba s: This is the name of the file containine the t4t 
base source tibrary. If this parameter is not given = an 742 
attempt is made to access a file with the name BASE. 343 
: G& 

result ! er : This is the file to receive the aitered 345 
library. If this parameter is not given, it will be 746 
written to a file named RESULT. 347 
48 
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status i st : See basic status concept. 


Exampte: 
Scuechange_tibrary version=*1.0° ba=mylib 
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Seie& COMBINE _LIBRARY ? COL 


This command merges the decks from a tist of source 
iibraries into a singie result tibrary. The result tibrary 
will inciude one deck by every name encountered on any of the 
source tibraries. [f decks by the same name occur on more 
than one tlibrary the deck from the ftibrary listed first witt 
be selected. Decks will have the following tiogical order on 
the result ftibrary: 


Le Alt decks with names occurring on the ftast named 
source jibrary wilt occur first in their originat 
ordere 


Ze Next the decks with names occurring on the next to 
fast named tibrary witi occur in the order they 
occurred on that library. 


3e Decks with names occurring on the remaining tibraries 
witi occur in turn in the order they occurred on 
those tibraries. 


All source libraries must have the same key character. The 
resutt source library will have the Satie authorities, 
description, etc. as the tast named source iibrary. This 
command will indicate an error if there are any § iintertock 
violations {see discussion of inter lock under 
EXTRACT_LIBRARY). 


combine_tibrary base=<file_name> 
{result t=<file_name>!] 
{Ctist=<tocal_fite_name>] 
{tbrief 1 full] 
{status=rilir2ir3iefl 


base I ba ? This is a tist of names of files containing 
source fibraries to be combined. Tre names must be 
enclosed in parentheses and separated by commas. 


result ior: This is the fite to receive the combined 


source library. If this parameter is not given, the 
combined source tibrary wilt be written to a file named 
RESULT. 


list 2 1 : This is the name of the file which receives 
the tisting. The iist shows from which source tibrary 
decks on the resuit file were taken. If this parameter 
is not given, the file name OUTPUT will be used. 
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brief ? br ? full ? fu : These keywords can be used to 
select a shorter cr more detaited listing. Currentiy 
both ftistings are the same. 


status ! st 3 See basic status concept. 


Examples 
scuecombine_tibrary (changed,new,bdase) newbase 


In this exampte two source iibraries on files named CHANGED 
and NEW were combined with one on a file called BASE to form a 
result on a file named NEWBASE. To ilfuustrate how decks are 
selected and ordered during the orocessing of this command 


(and give an exampte of how this command is intended te be 


used) let us assume that the three libraries being combined 
each contained the fottowing decks’ 


CHANGED NEXH_ BASE NEWBASE  OQeck Taken From 
CURT SHARON JIM JIM CHANGED 
JIM ED BCB BoB CHANGED 
MIKE MIKE MIKE CHANGED 
BOB BILL BILL BASE 
SHERMAN SHERMAN BASE 
CURT CURT CHANGED 
JCHN JOHN BASE 


HARVEY HARVEY BASE 
SHARON NEW 
ED NEW 


In the example above the file named CHANGED had decks’ that 
also occurred on the file named BASE. These were selected 
rather than their duplicates from BASE, but were placed on 
NEWBASE in the same retetive position as their counterparts. 
The decks from NEW which were not duplicated were added at the 
end of the deck sequence from BASE in the order they occurred 
on NEW. Likewise had there been any decks on CHANGED that had 
unique names they would have been added at the end of the deck 
sequence on NEWBASE. 

In the exampie above fiies CHANGED and NEW fKhad no decks by 
the same name. Had deck 80B also occurred on NEW, the copy of 
BOB from CHANGED would still) have been selected and piaced in 
the same position on NEWBASE. Had deck SHARON also occurred 
on CHANGED the copy from CHANGED would have been selected and 
it would nave been placed in the same position as shown in the 
example. 
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3ei25 ADD_LIBRARY 2? ADL 
3SeieS ADD_LIBRARY ? ADL ; 
This command merges the decks from a t4ist of source j 
libraries into a singie resuit library. The result tibrary i 
will inctude one deck by every name encountered on any of the 3 
source tibdraries.e If decks by the same name occur on more ' 
than one of the tibraries these decks will not be written on 3 
the result library and the duptication wilt be reported in the : 
listing. Decks will have the following togicai order on the ' 
result tibrary: 719 
11 
Le | decks occurring on the tast named source library #12 
wilt occur first in their original order. 713 
16% 
20 Next the decks occurring on the next to tast named 115 
iibrary will occur in the order they occurred on that #16 
fibrary. 117 
18 
3e Decks occurring on the remaining tibraries wit! ccecur 719 
in turn in the order they occurred on those 129 
iibraries. 321 
22 
Ail source libraries must have the same key character. The 123 
result . source f{ibrary witt have the same authorities; 1246 
description, etce as the tast named source tibrary. 325 
26 
add_library base=<file_name> 327% 
{result=<file_name>] 128 
Ciist=<tocai_filte_name>! . 129 
{brief 7? fulf] 138 
(status=riir2irsief) 931 
32 
base i ba 3 This is a tist of names of files containing 133 
source libraries te be combined. The names must be 734 
enciosed in parentheses and separated by commas. 35 
36 
result iro: This is the file to receive the combined 137 
source tibrary. If this parameter is not given, the 138 
combined source !fibrary will be written to a file named 139 
RESULT. 740 
Gi 
fist t 1 : This is the name of the file which receives 142 
the listing. The tist shows from which source iJibrary 143 
decks on the result file were taken. If this parameter 144 
is not givens the fite name OUTPUT will be used. 745 
46 
brief i? br $$ full ? fu 3 These keywords can be used to 147 
select a shorter or more detaited tistinge Currentty 748 
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3eieS ADD_LIBRARY { ADL 


both tistings are the same. 
status i st 3 See basic status concept. 


Examples 
scueadd_tibdrary (green snen,base) newbase 


In this example the decks on the tibraries on the files 
named GREEN and NEW are sadded to those on the ftibrary on fite 
base to form a resuit on 3a file named NEWBASE. To iftustrate 


how decks are seiected and ordered during the processing of. 


this command tet us assume the three tibraries being combined 
each contained the following decks: 


GREEN NEW BASE NEWBASE Deck Taken From 
FRED SHARON = JIM JIM BASE 
GORDY ED BOB BoB BASE - 
AL MIKE MIKE BASE 
Juby BILL BILL BASE 
SHERMAN SHERMAN BASE 
CURT CURT BASE 
JCHN _ JOHN BASE 


HARVEY HARVEY BASE 
SHARON NEW 


ED NEW 

FRED GREEN 
GORDY GREEN 
AL GREEN 
JUDY GREEN 


In the example above there were no deck names duplicated on 
the three fibraries. On fhe file NEWBASE the decks from BASE 
occur first in their original order fottowed by the decks from 
NEW and GREEN. 

Had any deck names beer dupticatedse none of the dupticates 
would thave been written to NEWBASE and the user would have 
been informed. 
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 3eie6 REPLACE_LIBRARY i REL $i 
2 

This command merges the decks from a tist of source 1 3 
{ibraries into a singte result library. fhe result library + & 
will include one deck by every name encountered on the tast 15 
named source library. If decks by the same name occur on more 3 6 
than one library the deck from the fibrary tisted first wil! 3; 7 
be selected. Decks with names that do not occur on the fast 18 
named tibrary wilt not be inctuded in the result tibrary and 7 9 
that fact witli! be reflected in the tisting. Decks will nave #10 
the following togical order on the result tibrary3 117 
12 

is Alt decks with names occurring on the last named 7413 
source library will appear in their original order. $18 

i5 

All source tibraries must have the same key character. The 216 
result source tlibrary wiil have the same autroritiess 1417 
description, etce as the tast named source library. This 718 
command witli be indicate an error if there are any intertock 1193. 
violations (see discussion of inter tock under 120 
EXTRACT_LIBRARY). 72f 
22 
reptace_library base=<file_ name> 123 © 
{resui t=<file_name>] i24 
{Tiist=<locai_fite_name>]) i25 

{brief i? full] +28 
{status=rtiir2irgiefl 327 

28 

base 3? ba : This is 8 tist of names of files containing %29 
source tibraries tec be combined. The names musf be 138 
enclosed in parentheses and separated by commas. 131 

. ; 32 

result !{ r 3 This is the fite to receive the combined 133 
source tibrary. If this parameter is not givens the 134 
combined source iibrary wiit be written to a fite named 335 
RESULT. 136 

37 

fist %? t 2? This is the name of the file which receives 138 

the listing. The tist shows from which source tibrary 139 
decks on the result file were takene If this parameter 740 

is not given, the file name GUTPUT will be used. 14f 

4&2 

brief i br ?t full ? fu 3 These keywords can be used to 143 
select a shorter or more detailed tistinge Currentiy 24% 

both iistings are the same. 145 

&6& 

status i! st 3 See basic status concept. 147 

4&8 
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3e1i.26 REPLACE_LIBRARY ? REL 


Examptes 


scuereplace_ library (chanced,snew,base) newbase 


In this exampie two source libraries on files named CHANGED 
and NEW were combined with one on a file calted BASE to form a 


result on a file named NEWBASE. 


To ittustrate how 


decks 


are 


selected and ordered during the processing of this command, 
fet us assume that the three fibraries: being combined each 
contained the following decks: 
CHANGED. NEW BASE Deck Taken From 
CURT BILL JIM JIM CHANGED 
JIM HARVEY B8CB BOB CHANGED 
MIKE MIKE MIKE CHANGED 
B08 BILL BILL NEW 
SHERMAN SHERMAN BASE 
CuRT CURT CHANGED 
JCHN JOHN BASE 
HARVEY HARVEY NEW 
In the exampte above the files named CHANGED and NEW had 
decks that also occurred cn the file named BASE. These were 
selected rather than their dupticates from BASE, but were 
piaced on NEWBASE in the same retative position as their 
counterpartse 
Had there been decks on CHANGED or NEW that did not arpear 


on BASE, 
user would have been informed. 


they would not have been written to NEWBASE 


and 


the 
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Sele? EXTRACT_LIBRARY 1 EXL 


This command is used to isotate a source tibrary with onty 
a subset of decks on it for manipulation by the SCU editor or 
maintenance as a separate source library. If the INTERLOCK 
option is used, the user must have write access to the  fite 
named with tne BASE parameter. 


extract_tibrary (€name=<deck namer>iali] 
{criteria=<focal_file_ name>] A 
Cinter lock=<user_name> i no_intertock] 
{base=<file_name>} 
{result=<file_name>] 
Cstatus=riir2irgief] 


name ! na ft afi 32 This is the name of a deck to be 
extracted. <Alternativety a list of names separated by 
commas and enctosed by parentheses may be given or 4a 
range of decks may be indicated by giving the first and 
fast deck names to extract separated by ellipses. Use of 
the aiternate keyword ALL to svnecify this parameter has 
the same effect as specifying the first and tast decks as 
arangee If this parameter is omitted, the contents of 
the source library to be extracted wil! be determined 
solety by the contents of the criteria file. 


criteria it cr 3: This names a file which can be used to 
further define which source data is to be inciuded on the 
subset source tibrary. 


interiock ! int ! no_intertock ! nint & This parameter 
erovides a means to altow oniy the peopntie authorized to 
use a cvarticular user name to aiter the decks being 
written to the subset tibrary. The vatue of the 
parameter may be given as a user name or if the keyword 
INTERLOCK onty is given the user name the command is 
executed under witli te usede When a deck is interlocked, 
an attempt to extract it to a subset library setting the 
interiock will be rejected. Also an attempt to reptace 
the deck on a source tibrary by doing a COMBINE_LISRARY 
or REPLACE_LIBRARY with the base wili be rejected, unless 
its from the subset library with the interlock set. If 
the command inctudes the NOLINTERLOCK keyword the user 
wili be attowed to extract a subset source tibrary 
whether or not the decks he requests are intertockede An 
attempt to interiock decks with this command will be 
rejected if the criteria file contains directives which 
cause modifications to be excluded. If neither keyword 
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is present. the command is processed as if NO_INTERLOCK 
had been specified. 


base 1 ba ? This is the name of the file containins the 
base source tibrary. If this parameter is not given an 
attemot is made to access a file with the name BASE. .- 


result 7% rr 3: This is the fiie to receive the subset 
source tibrary. If this oarameter is not givens, the 
subset source tibrary wilt be written to a file named 
RESULT. 


status ! st 3 See basic status concept. 


Examples’ ; 
scueextract_fibrary dsd int=johndoe r=tempo! 


In this exampte a subset fibrary is extracted from the 
source tibrary on the file named BASE which inctudes only the 
deck dsd. This subset source tibrary is written to aé_e§ file 
named TEMPPL and the deck dsd is intertocked for user name 
JOHNDOE. 
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3-2 SOURCE DECKS 


These commands are available for creating and manipulating 
Source decks. 


3e2ei CREATE_DECK + CRD 


This command is used to create source decki{s). 


create_deck name=((<deck_name>{,<iocal_file_name>1) esx.) 1 


names on_fiile=<focatl_fite name> 
modification=<modification_name> 
Cafter=<deck_name>ibe fore=<deck_name>taiphabetici 
fauthor=<author_name_string>] 

tdescript ion=<deck _description_string>] 
{processor =<processor_name_string>] 
{group=<group_name>] 
(tab=<tab_character>tnotab] 
Ccoilumns=<tab_column_integers>] 
twidth=<integer>] 
Ciid=<ftine_identifier_piacement_keyword>] 
[base=<file name>] 

{fresult=<file_ name>] 

fexpand {! no_expand]) 

(muiti_oartition ! single_partition! 
{same_as=<deck_name>} 
istatus=riir2ir3siefi 


name % nai names_on_fiie i nof : This parameter must be 
given in one of the two forms shown below. If the NAME 
or NA keyword is used for no keyword is given), the 
required portion of this parameter is a 1 to 31 character 
deck namee It may optionalty be fottiowed by the name of 
a focal fite containing source data to be incftuded in the 
deck as texte. <Afternatively a list of deck names or deck 
names and file names may be given {see the Parameter 
Lists section of the NOS/VE ERS). Alt decks created with 
a Single CREATE_DECK command will have identicat 
descrinotive information taken from the other parameters 
on this command. An attemotf to create a deck with the 
same name as one afready on the base source tibrary witt 
be rejected. [f the keyword NAMES_ON_FILE or NOF is 
used, this parameter names a file from which initial text 
for decks wil! be read. Deck names wil! be taken = § from 
*DECK text embedded directives intermixed with the 


initial text. 
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modification ! mod ?: This 1 to 9 character modification 


t 

name wilt be associated with the creation of this deck 2 2 
and included as part of the tine identifier for att 1 3 
initiat lines of text if any are introduced with this i 6 
commande 7 5 
6 

after ?! af 1 before i be ! ainhabetic $ alpha =? This 4 
parameter can be used to name a deck on the iibrary after 8 
or before which this deck will be added. [f the keywords + 
AFTER or BEFORE are used alone, the deck will be added at 10 
the end or beginning of the the deck sequence 41 
respectively. Aiternativety the ALPHABETIC keyword may 12 
be ysed to indicate that the deck will be added in 13 
alohabetic sequence. If this parameter is omitted the 14 
deck wilt be addec in atnhabetic sequence. 15 
16 

author 7 au ? This 1 to 31 character string is provided 347 
to identify the person who wrote this unit of source 118 
data. | 1193 
28 
description ! de 3 This i to 256 character string is used i242 
to describe this ceck. 122 
23 

processor {9 3: This 1 to 31 character string is used to 2& 
identify the orocessor that will use the source data in 25 
this deck as input. 26 
2? 

group i 93: This is a1 to 314 character group name to be 28 
associated with this deck. <Aiternativety a list of group 29 
names may be given separated by commas and enclosed in 30 
parentheses. 31 
32 

tab {! notab : If the TAB keyword is used or this 133 
parameter is given positionaliy, this one character 73& 
string specifies a default tab character for use when $35 
editing this decke If the NOTAS keyword is given tabbing. 336 
witt be deselected by default for this deck. 137 
38 

columns ! col 2 These integers between i and 256 are the 139 
defautt tab stoos when editing this decke A series of $40 
tab cofumns may be specified as a vaiue tist {see the 14% 
Parameter tists section of the NOS/VE ERS). A maximum of $42 
256 tab columns may be specified. 143 
&& 

width i ws This is the default tine width to be used 145 
when this deck is expanded and to be used by the SCU 146 
editor. The vatue must be given as an integer between 0 167% 
and 256. Specifying 0 as a width selects the defaults of 748 
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suppiying no trailing planks when this deck is expanded 
and allowing tines up to 256 characters to be entered 
with the editor. If this parameter is not given a 


default value of 0 will be used. 


lid : This parameter is the default line identifier 


otacement when this deck is expanded. [If this parameter 


is omitted the expanded text file wilt contain no tine 
identifiers. This parameter can be given as one of 3 
valuese 


right % Line identifiers will be placed on the 
right. 


jeft * Line identifiers will be piaced on the lefte 


none 3 Outout fines wilt contain expanded text 
ontiy. 


base 1 ba ? This is the name of the file containinsc the 
base source tibrary to which the new decks are to be 
added. If this parameter is omitted an attempt is made 
to access a file named BASE. 


result 7? ro: This is the file to receive the modified 
source f{ibrary. If this parameter is not given, the 
modified source iibrary wiili be written to a file named 
RESULT. 


expand ! exo $ no_expand {! nexp $s If the NO_EXPAND 
keyword is inciuded on this command these decks will onty 
be written to the expanded text fite produced by the 
EXPAND_DECK command as a result of processing the text 
embedded directives *COPY and *COPYC. If the EXPAND 
keyword is incituded or this parameter is omitted 
entirety, these decks will be written to the expanded 
text file by the EXPAND_DECK command whether named on the 
command or on *COPY and *COPYC directives. . 


multi_partition t mp 1 singte_partition ! sp 2 If the 
MULTI_PARTITION keyword is included on the command, each 
end of record encountered in the source fite witli be 
reoresented on the source Sibrary as a *WEOP text 
embedded directive. If the SINGLE_PARTITION keyword is 
used or this parameter is omitted entirely, onty the text 
before the first separator on the source file witt be 


represented on the source library. 
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same_as 1! sa 3 This specifies the name of a deck on the 
_ base ftibrary. Vatues from that deck*s header witli be 
used to supply vaiues not given explicitty on this 
command for the author, descriptions processor, group, 
tab, columns, width lids and expand/no_expand 


parameters. 


status i st 3 See basic status concept. 


Exampie 1: 


scuecreate_deck ee 


name=(lampt$get_direct,srcfilte)) .. 


modification=original .. 
author=*R. De Palm* 2 


descrioption=*Get Direct modulee” ee 


processor=‘*CYBIL/CI* ee 
group=file_io e- 
same_as=file_io_orotot ype 


In this exampie, a new deck named amptget_direct is 
source tibrary on file BASE. 


to the 
written on the file RESULT. 
read from file SRCFILE 


modification name original associated with ite 
processor and 


descriptions 
explicitly on the command. 
parameters will be copied 
named file_lo_prototype. 
an eitipsis at the end of 
used to make the command more 
maintain or modify 
file. 


Exampte 23 
scuecrd William Cody bilt 


In this exampie the deck 
f{ibrary on file BASE and 
RESULT. The creation of the 
modification name biitfe No 
deck (it may be added tater 


The initial 


In this examoie the ability to 


added 
Tne entarged tibrary is 
text for the deck is 
fine will have the 
Tne author, 

grouod parameters were given 

Vatues for the remaining 
from the descrirtion of the deck 
use 
a tine to continue a command was 
readabte and vossibiy easier to 


and each 


shouid it be used as part of a procedure 


WILLIAM_CODY is added to. the 
the resuit is written to file 
deck is associated with the 
initial text is supplied for the 


with the editcr) and default 


vatues are supplied for ati the other parameters. 


Example 33 
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scuecreate_deck e. 

fueve (wnewfileadsxeyszZ) ee 
encrypto e- 

author="M. Je Perreten* oe- 
same_as-CYBIt_type_dectarations 


In this exampte decks u through z are added to the source 
library on fite BASE. The enlarged tibrary is written to the 
file RESULT. Deck w has initiait text supplied from file 
WFILE. The modification and author fields are aiven 
explicitity on the commande Values for the remaining 
parameters will be copied from the description of the deck 
named CYBIL_ type_dectarations. 


Exampie 4&3 


scuecreate deck es 

nof=augusf ee 

numberi2 es 

author="Henry McGilton" e-« 
description=*August Toots Bulletin® 


In this exampte text for some deck or decks is read from a 
file named August which contains DECK text embedded 
directivese This deck wil! be added to those on the iibrary 
on file BASE and the result written to a file named RESULT. 
The modification name associated with each line in the new 
deck will be NUMBER12. Henry McGilton is identified as the 
author and the deck is described as containing the August 
Tools Bulletin. 
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3e2e2 DISPLAY_DECK 7 DID 


This command displays descriptive information about the 


decke 


displ 


ay_deck name=<deck_name>iaii 
(base=<file name>] 
Ctist=<tocai_file name>} 
torief 7 full] 
{notext 1 active 1! inactive] 
Cstatus=riir2irstef] 


name 7 na 1 alt : This is the name of a deck fo be 


dispiayed. Aiternativety a iist of names separated by 


commas and enciosed by parentheses may be given or a 
range of decks may be indicated by giving the first and 
fast deck names to display separated by ellipses. Use of 
the alternate keyword ALL to specify tnis oarameter has 
the same effect as specifying the first and tast decks as 
a range. 


base i ba 3 This is the name of the file containing the 
base source library. If this parameter is not given an 
attemot is made to access a fite with the name BASE. 


fist ? ! : This is the name of the fite which receives 
the tisting. If this parameter is not givens, the file 
name OUTPUT will be used. 


brief ? br i full! ? fu : If the BRIEF keyword is inciuded 
on this command, onty the descriptive information from 
the deck header wil! be disptayed. If the FULL keyword 
is used the fist of modification names and group names 
assoctated with this deck will be displayed as well. 
Omitting this parameter gives the brief display. 


notext 3 active ¢ act ?!? inactive 1! inact 3 If the 
INACTIVE keyword is inctuded on this command both active 
and inactive tines from the deck wilt) be dispiayed. [f 
the keyword ACTIVE is given onty the active tines in the 
deck wit! be dispiayed.e If the NO_TEXT keyword Is given 
or this parameter is omitted entirety none of the = text 
fines of the deck will be disolayed. 


status ! st ? See basic status concept. 


Examofes 
scuedisptay_deck dsd full 
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The command in this example tists 
information from the header of deck dsd 
“fibrary on file BASE as well as the tist of 
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tne descrintive 
from the source 
modification and 


group names associated with this deck.» The text tines of the 
deck are not included in the tisting. The ftisting Is written 


to the file cailited OUTPUT. 
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SANA MM Kane | 


3e2e3 CHANGE_DECK ? CHD 
This command is used to change fietds in the deck 
description. 
change_deck name=<deck_name>lall i 
fautnor=<author_name_string>!] 
{intertock=<user_name>] 
{tdescription=<deck_description_string>] 
Tprocessor=<processor_name_string?i 198 
{group=<group_name>] 1i 
{delete_ogr oup=<group_name>] i2 
{tab=<tab_character>inotab] 713 
{columns=<tab_column_integers>] 14 
{delete _columns=<tab_cotumn_integers>} 15 
{width=<in teger>]} 416 
Clid=<tine_identi fier_piacement_keyword> } 17% 
(base=<file_name>] 318 
{result=<file_ name>] | #19 
{expand ! no_expand] | 128 
{istatus=rlir2irsiefi 24 
22 
name ?tonaié ati 3? Tris is the name of a deck to have its 123 
description aitered. Aiternativeiy a tist of names 24 
separated by commas and enctosed by parentheses may be i25 
given or a range of decks may be indicated by giving the 126 
first and tast deck names separated by etlipses. Use of i27 
the alternate keyword ALL to specify this parameter has 128 
the same effect as specifying the first and tast decks as 129 
a ranges i398 
3t 
author 3 au 2 This i to 31 character string is orovided 732 
to identify the person who wrote this unit of source 133 
datae $34 
| 35 
intertock ! int 2 This oarameter is included to attow tne 368 
interlock for a deck (see the EXTRACT_LIBRARY command) to 3? 
be changed or cieared. [It is altered by supplying a new 38 
user name as the vatue for this parameter and it is 39 
cleared by supplying the ke yword INTERL OCK oniye & 8 
Altering this field is restricted to the user name which Gi 
has authority 4& for this library. Clearing this fietd is 4? 
restricted to the user name which has authority 4 for the — 4&3 
library or the user name for which the interlock is sefe 44 
45 
description ! de ? This i to 256 character string is used 146 
to describe tne contents of this deck. {47 
48 
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processor 1 9 3 This 1 to 31 character string is usec to 
identify the processor that will use the source data in. 


this deck as input. 


group ? g: This is a1 to 31 character croup name to, be 
associated with this deck. Aternatively a tist of eroup 
names may be given separated by commas and enciosed in 
parentheses. 


detete_group 1 dg 3% This parameter ailows group names to 
be deleted from the deck header. The vyaiue of this 
parameter is given as a singie group name or a tist of 


group names separated by commas and enctiosed in. 


parentheses. 


tab ! notab : If the TA8 keyword is used or this 
parameter is given positionaltty, this one character 
string specifies a default tab character for use when 
editing this decke If the NOTAB keyword is given tabbing 
wili be deselected by default for this deck. 


columns 1 col 3 These integers between 1 and 256 are tab 
stops to be added to the deck header. A series of tab 
columns to be added may be specified as a value tist (see 
the Parameter tists section of the NOS/VE ERS). A 
maximum of 256 tab columns may be specified. When the 
detete_coiumns parameter is aiso included on this 
command, the tab stops it specifies are cleared before 
the tab stops specified by the cotumns parameter are 
set. 


deiete_columns 3? dcof : These integers between 1 and 256 
are default tab stops for editing to be deleted from the 
deck header. A series of tabs stops may be specified as 
a vaiue tist (see the Parameter tists section of the 
NOS/VE ERS). 


width ? w 2? This is the default line width to be used 
when this deck is expanded and to be used by the SCU 
editor. The vaiue must be given as an integer between 0 
and 256.4 Specifying 0 as a width sefects the defaults of 
supplying no ftraiiing blanks when this deck is expanded 
and allowing tines ur to 256 characters to be entered 
with the editor. 


lid 3: This parameter is the defauit fine identifier 
placement when this deck is expanded. This parameter can 
be given as one of 3 values. 
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right : Line identifiers witli be placed on the 
right. 


feft 3 Line identifiers witt be placed on the teft. 


none 3 Output iines witt contain expanded text 
oniyve j 


base ! ba ? This is the name of the file containing the 


base source library. If this parameter is not given an 
attempt is made to access a file with fhe name BASE. 


result ior 3: This is the file to receive the modified 


source ftibrary. If this parameter is not givens the 
modified source tibrary will be written to a fite named 
RESULT. 


expand { exp %t no_lexpand 1 nexp 3: If the NO_EXPAND 
keyword is incituded on this command these decks will only 
be written to the expanded text file produced by the 
EXPAND _ DECK command as a result of processing the text 
embedded directives *COPY and *COPYC. If the EXPAND 
keyword is inctuded or this parameter is omitted 
entirely, these decks wili be written to the expanded 
text file by the EXPAND_DECK command whether named on the 
command or on *COPY and *COPYC directives. 


status ? st 3: See basic status concept. 


Examptes 
SCUeCHD scmfdeiete po="*CYBIL" 


In this exampte CYBIL is identified as the processor that 
will use this deck as input. The description of the deck 
scmf$delete wil! be obtained from file BASE and the modified 
source tibrary will be written to the fite RESULT. 
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302% PURGE DECK { PUD 


This command is used to remove decks from a source 
library. This command will be rejected if the user name it is 
executed under does not have an authority equat to or higher 
than the state of the modification associated with this deck*s 
creatione 


purge _deck name=<deck_ name> 
{base-<file_ name>] 
{resul t=<file name>} 
istatus=riir2irsief) 


name ! na ® This is the name of a deck to be ovourged. 
Atternativety a i iist of names separated by commas and 


enctosed by parentheses may be given or a range of decks 


may be indicated by giving the first and last deck names 
to putmge separated by eltlioses. 


base 3} ba 2 This is the name of the file containing the 
base source library. ' If this parameter is not given an 
attemot is made to access a file with the name BASE. 


result iro: This is the fite to receive the modified 


source iibrary. If this parameter is not given, the 
modified source jiibrary witi be written to a fite named 
RESULT. 


status i st 3 See basic status concept. 


Exampie: 
scuepurge_deck soup..enuts current shorter 


In this example the source library on file SHORTER wiit 
contain all of the decks in the source ftibrary on fite CURRENT 
except those in the range from soup to nuts. 
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$e225 SEQUENCE _DECK ! SED 


This command is used to resequence a deck. Onity tines 


associated with modifications of state 4% will be altered. The 
modification identifier under which the deck was created wilt 
be associated with each of these tines on the result tiborary. 
Ali history information concerning previous modifications to 
these lines witli be discarded, including inactive tines. 
Because of thiss resequencing is recommended only when a deck 
has attained some significant mitestone. This command is 
rejected if it is not executed under the user name which has 
authority & for the library. 


sequence_deck name=<deck_name>tati 
{base=<filie_ name>] 
{result=<file name>] 
{status=rtiir2ir3gief } 


name !{ na! aif’ 3 This is the name of a deck to be 


resequencede. Aiternativeiy a tist of names separated by 


commas and enctosed by parentheses may be given or a 
range of decks may be indicated by giving the first and 


fast deck names to resequence separated by ellipses. Use 


of the aiternate keyword ALL to specify this parameter 
has the same effect as specifying the first and tast 
decks as a rangee 


base ! ba 3 This is the name of the file containine the 
base source tibrarye If this parameter is not given an 
attempt is made to access a file with the name BASE. 


result t er 8&8 This is the fite to receive the modified 
source ftibrary. Tf this parameter is not givens, the 
modified source tibrary will be written to a fite named 
RESULT. 


status ?! st 2 See basic status concept. 


Example: 
SCueSequence_ deck name=(Bob,Carol »TedsAlicesya..Z) Oldplsr=joe 
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3e2e6 MOVE DECK # MOD 


This command is used te move a deck to another § tlogica!} 
position on the source tiibrary. 


move_deck name=<deck_name>ial 4 


Cafter=<deck_name>ibefore=<deck_name>laionabetic) 
{base=<file_name>] 

{resulft=<fite name>} 

(status=riir2ir3ief ] 


name { na ? aft: This Is the name of a deck to be 
movede Aiternativeiy a Uist of names separated by commas 
and enctosed by parentheses may be given or a rance of 
decks may be indicated by givina the first and last deck 
names to move separated by eltioses. An error will be 
reported if an attempt is made to move a range of decks 
to a destination within the ranges The alternative 
keyword ALL will be allowed onty if atphabetic ordering 
is selected and wilt have the effect of sorting the decks 
on the result library. 


after i af i before { be ! atohabetic { aiphna =: “This 
parameter can be used fo name a deck on the library after 
or before which this deck will be movede If the keywords 
AFTER or BEFORE are used aiones this deck will be moved 
to the end or beginning of the deck sequence 
respectively. Aiternatively the ALPHABETIC keyword may 
be used to indicate that the deck wilt be moved to 
alphabetic sequence. If this parameter Is omitted the 
deck wili be moved fo atohabetic sequence. 


base ? ba : This is the name of the file containing the 
base source tibrary. If this parameter is not given an 
attemot is made to access a file with the name BASE. 


result ? ro: This is the fite to receive the modified 
source fibrary. If this parameter is not givens the 
modified source tibrary wit! be written to a file named 
RESULT. 


status ? st 3: See basic status concept. 


Examples 
scuemove_deck r=newp! na=Anatoly after=Bobby oildp! 


this examole the use of keywords has allowed the 


parameters to be specified in something other than the default 
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3e2e7 EXPAND_DECK ? EXPD 


This command expands a source deck into a file where it may 
be used as input to some processor. During the course of 
expansion, text embedded directives intermixed with the source 
Will be processed. For ae description of these, see the 
section on text embedded directives. 


expand_deck [name=<deck_name>ialil} 
{compiie=<ftocai_file name>] 
{criteria=<iocal_file_name> ] 
Ctwidth=<integer>] 
tlid=<tine_identifier_piacement_keyword> } 
Cbase=<fite name>] 
{list=<tocal_filte_name>} 
Cdenth=<integer>] 
tbriefifull] 
{library_order ? command_order] 
{status=riir2irsief] 


name % na %? att 3 This is the name of a deck to be 
expanded. Aiternatively a tist of names separated by 
commas and enctiosed by parentheses may be given or a 
range of decks may be indicated by giving the first and 
last deck names to exoand separated by eliinpses. The use 
of deck ranges on this command for anything other than 
decks occurring on the last named source tibrary is not — 
recommended {See description of the LIBRARY_ORDER keyword 
below). Use of the aiternate keyword ALL to specify this 
parameter has the same effect as specifying afl decks 
from a combined library as a range. If this parameter is. 
omitted, the source data to be expanded will be 
determined sotely by the contents of the criteria file. 


compite 2% cc $3 This is the name of the file for the 
expanded text. This file will be rewound before and 
after the command is processede [If this parameter is not 
given, the expanded fext will be written to a file named 
COMPILE. 


criteria % cr 2? This names a fite which can be used to 
further define which source data is to be expanded. Tf 
no criteria file is used, the sefected decks will be 
expanded wifh all modifications included. 


width i? ws: This is the tength of the output lines 
excluding iine identifiers if they are requestede A 
maximum vatue of 256 will be aliowed. An additional 17 
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columns will be necessary for a tine identifier since a 
blank wilt separate the modification identifier from the 
sequence number and another blank wiftt separate the 
entire tine identifier from the expanded text. If 0 is 
specified as the vaiue for this parameter, output tines 
will be actual tength. If this parameter is not given on 


the command, the default vatue from the deck header wil 


be usede If the width selected resuits ina tine being 
truncateds an error wiil be reported. 


lid 3 This parameter can be given as one of 3 values. 


right : tine identifiers wilt te piaced on the 
right. 


jeft * Line identifiers wiit be piaced on the teft. 


none $: Outout fines wilt contain expanded text 
oniye 


If this parameter is not given on the command, the 
defauit vatue from the deck header is used. 


base % ba 3? This is the name of the file containins the 
base source tibrary. Afternatively a list of fite names 
may be given to allow decks to be expanded from atternate 
source tibraries.e See normal search ordere if this 


parameter is not given an afttemot is made to access a 


fliie with the name BASE. 


fist 1 1 3: This is the name of the file to receive the 
listing. If this pcarameter is not givens the file name 
OUTPUT will be used. 


depth : This non-negative integer timits thow deeply 
nested *COPY or *COPYC text embedded directives wiil be 
processed. *COPY or *COPYC directives encountered at the 
next fteveil will be inctuded In the expanded text file as 
text tines. If this parameter is omitted, *COPY or 
*COPYC directives wit!l be processed wherever they are 
encountered. 


brief { or ? full i fu 2 If the BRIEF keyword is present 
or this parameter is omitted, the list wiit contain only 
a report of errors which may have occurred white 
processing the commande. If the FULL keyword is presents 
an expfanation of which tibrary each deck was selected 
from will be included when the command accesses muitipte 
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source tibraries. 


fibrary_order t to 1 command_order ! co ? If this command 
inctudes the COMMAND_ORDER keyword the decks will be 
written to the exrcanded text file in the order they are 
specified on the commande If the LIBRARY_ORDER keyword 
is included or this vcarameter is omitted, tne decks are 
written to the expanded text file in the order that the 
decks occur on the base source library (or in the order 
they would occur on a combined source library if one were 
produced from the tist of fibraries specified by the base 
parameter). 


status ? st 3 See basic status concept. 


Exampie i? 
SCuee@xpand deck mydeck ba=-oldpt 


In this exampie the deck mydeck is expanded from the source 
library on the fite OLDPL and written on the expanded = text 
file named COMPILE. 


Example 23 | 
Scueexpand_deck scm$change ba={myop!, (cybccmn,ses)) 


In this exampte the deck scm$change is expanded from the 
libraries MYOPL and CYCCCMN and written on the expanded text 
fite named COMPILE. In this case CYBCCMN was tocated under 
another user name. 
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3e2e8 EXTRACT_DECK 1 EXTD i 
| ; 2 

This command performs a function simitar to EXPAND_DECK 3 
with the exception that text embedded directives are not & 
processed but included as texte 5 
6 
extract _deck [name=<deck_name>talt} ¥ 
{source=<local_ tite name>] 3 
{criteria=<tocal_file_name>l 9 
Cwidth=<inteser>] 18 
Ciid=<fine_identifier_piacement_keyword>] it 
{base=<fiie name>} 712 
Ciist=<!ocai_filte_name>] {13 
Cbriefifull] : 1148 
{iibrary_ordericommand_order] 15 
Cexpandino_expand) #16 
{ideck_directivesino_deck_ directives! 147 
Istatus=rlir2irgiet) 718 

19 

name t{ na ioali : This is the name of a deck to be 120 
extracted. Aiternativety a  itist of names separated by 21 
commas and enctosed by parentheses may be given or 4a 122 
range of decks may be indicated by giving the first and 323 
iast deck names to extract separated by ellipses. Fhe i2& 
use of deck ranges on this command for anything other 125 
than decks occurring on the tast named source tibrary is $26 
not recommended {See description of the LIBRARY_CRDER 127 
keyword below). Use of the aitternate keyword Att to 28 
specify this parameter has the same effect as specifying 29 
all decks from a combined ftibrary as a frangee If this 38 
parameter is omitted, the source data to be extracted 3t 
will be determined sclely by the contents of the criteria 32 
file. , 33 
3%& 

source i! s 3 This is the name of the file for the 235 
extracted text. Decks wil! be separated by end of. 236 
partition (end of record on NOS170). This file will be 337 
rewound before and after the command is processed. Tf 138 
this parameter is not given, the extracted text will be 393 
written to a file named SOURCE. 4D 
Gi 

criteria i cr 3: This names a file which can be used to 42 
further define which source data is to be extracted. If &3 
no criteria file is used, the selected decks will be && 
extracted with at! modifications inciudede 45 
46 

width i w# $$ This is the tength of the output Lines 4% 
excluding line identifiers if they are requested. K 48 
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maximum value of 256 will be allowed. 


An additional 17 


columns wiil be necessary for a line identifier since a 
blank will separate the modification identifier from the 


sequence number and another. biank 


separate the 


entire tine identifier from the extracted text. If 0 is 


specified as the vafue of this parameter, 


outout tines 


wilt be actual tengthe If this parameter is not given on . 
the command, the default value from the deck header wiili 
be usede If the width selected results in a line being 


truncateds an error witt be reported. 


fid 2? This parameter can be given as one of 3 values. 


right =: Line identifiers will 
right. 


placed on the 


feft 3: Line identifiers will be piaced on the teft. 


none : Output fines wilt contain 


oniye 


If this parameter is not given 


base | ba 3: This is the name of the file 


extracted text 


tne command, the 
default vaitue from the deck header is used. 


containing the 


base source tibrary. <Aiternatively a list of file names 


may be given to ation decks to 


alternate source tibraries. See normal 


extracted from 
search order. If 


this oarameter is not given an attempt is made to access 


a fite with the name BASE. 


fist 3 ] 2 This is the name of the file to receive the 
fisting. If this parameter is not given, the file name 


QUTPUT wiilt be used. 


brief 1 boro i full i fu 3: If the BRIEF keyword is present 
or this parameter is omitted, the list will contain  onty 


a report of errors which may have 


occurred while 


processing the commande If the FULL keyword is oresenf, 
an explanation of which tibrary each deck was selected 
from will be inctuded when the command accesses multiple 


source tibraries. 


fibrary_order 1 to % command_order { co 


inctudes the COMMAND_ORDER keyword 


If this command 
decks wilt be 


written to the extracted text file in the order they are 
specified on the command. If the LIBRARY_ORDER keyword 


is inciuded or this parameter is omitted, 


the decks are 
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written to tne extracted text fiie in the order that the 
decks occur on the base source fibrary tor in the order 
they would occur on a combined source tibrary if one were 
produced from the tist of tibraries specified by the base 
parameter). 


expand { exp 7 no_expand ? nexp 3 [f the EXPAND keyword 
is present on this command, onty decks without the 
NO_LEXPAND attribute will be written to the SOURCE file. 
If the NOG_LEXPAND keyword is present, only decks with the 
NO_LEXPAND attribute wilt be written to the SOURCE file. 


If neither keyword is present, decks wit! be written to 


the SOURCE fite without regard to their NO_EXPAND 
attribute. 


deck_directives {! dd! no deck directives ! ndd : If the 
DECK_DIRECTIVES keyword is present, BECK text embedded 
directives wilt precede each deck on the SOURCE file. If 
the NO_DECK DIRECTIVES keyword is used or neither keyword 
is presents no DECK directives wil! be written tc the 
SOURCE file. 


status ! st * See basic status concept. 


Examopte? 
scueextract_ deck mydeck ba=oldpt 


In this exampie the deck mydeck is extracted from the 
source tibrary on the file OLDPL and written on the text file 
named SOURCE. 
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32229 DISPLAY_DECK_REFERENCES 7? DOR i 
2 

This command displays the names of the decks which : 3 
reference the named deck directiy or indirectty by *COPY text it & 
embedded directives. It can optionaliy aiso dispiay the names 3; 5 
of the decks referenced by the named deck directiy or 1 6 
indirectty through use of the *COPY text embedded directive. i F 
8 

display_deck_ references name=<deck_name>tiall 9 
Cbhase=<file_ name>] 718 
Ciist=<focal_filte_name>] 211 

{tbriefiful!} 112 

(status=riir2ir3ief 313 

14 

name i na i alf' 3: This is the name of a deck to be cross is 
referenced. Aiternativety a list of names separated by 16 
commas and enctosed by parentheses may be given or a i7 
range of decks may be indicated by giving the first and 18 

fast .deck names to cross reference separated by 193 
ellipses. Use of the atternate keyword ALL to specify 20 

this parameter has the same effect as specifying the 2i 
first and iast decks as a range. 22 

23 

base : ba 3: This is the name of the file containing the 226 

base source tibrary. If this parameter is not given an 125 
attempt is made to access a fiie with the name BASE. #26 

27 

iist ! 1 #$ This is the name of the file which receives 28 

the tisting. If this parameter is not given, the file 293 

name OUTPUT will te used. 30 

. 31 

brief $! br ft full ! fu 3 If the BRIEF keyword is included 32 

on this command or this parameter is omitted entirely; 133 

oniy the decks which reference this deck witli be tisted. 134 

If the FULL keyword is used, the tist of decks referenced 135 

by this deck will be shown as wel!. References to decks 136 

not on the base source tibrary wilt be flagged as 13% . 
external. 738 

39 

status 1! st 3? See basic status concept. 148 

41 

Exampies: 342 
SCU.DDR scc$display_default_vatues scup! | 143 
&& 

The command in this exampte displays the names of ali the | 45 
decks on the source fibrary on file SCUPL which refer to the 46 
deck sccftdisplay_defauit_vatues directiy or indirectty through iG¥ 


*COPY directives. 148 
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322210 DISPLAY _DECK_LIST ! DDL 


This command displays the tlist of decks on a source 
iibrary. 


display_deck_list Cbase=<file._name>} 


Clist=<locail_fite_name>} 
{brief ! full] 
(status=rtiir2ir3ief] 


base 1! ba 3: This is the name of the file containing the 
base source ftibrary. Aiternatively a tist of file names 
may be given to sive a combined deck list. If this 
parameter is not given an attemot is made to access a 
file with the name BASE. 


fist i i : This is the name of the file nhich receives 
the iisting. If this parameter is not givens the file 
name OUTPUT willl be usede 


brief 3 br ? full 2 fu 32 If fhe command contains the key 
word BRIEF or this parameter is omitted, a shorter form 
of the listing wilt be produced. If the FULL keyword is 
present a more detaited listing wil! be given. Currentiy 
these tistings are identical. 


status % st % See basic status concept. 


Examples 
SCU.DDL scups sculist 
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Tnis command will display a tist of the decks associated 


with a group and optionaliy the short 


of the deck 


description (see DISPLAY_DECK) for at! decks associsted with 


this group name. 


disptiay_group group=<group_ name> 
{base=<file name>] 
{tist=<local_ file name>] 
{brief % full} 
(Istatus=riir2ir3ief ] 


group ? g ?: This is the name of the grouc. 


base i ba : This is the name of the file 


containins the 


base source ftibrery. Aiternatively a list of file names 
may be given to ailtow a user to interrogate a set of 
source tibraries that are frequentiy used together. [If 
this parameter is not given an attemot is made to access 


a file with the name BASE. 


tist H 1 : This is the name of the file which receives 


the tisting. If this parameter is not 


name OUTPUT will be used. 


civen, the file 


brief ! br 1 fult 1 fu 3 If the command inctudes the 
keyword BRIEF, onty the ltist of decks associated with the 
group will be displayed. If the keyword FULL is present, 
the short form of the deck description for each deck witt 
be given as well. The shorter display is selected by 


default. 


status ! st 3: See basic status concept. 


Exampte: 
scuedisolay_group ati_iou_programs oldpl 


3e2ei12 DISPLAY_GROUP_LIST ? OGL 


This command wil! tist ali the group names associated with 
this source tibrary as well as the decks associated with each 


gr OUD « 


disptlay_groun_list (base=<filte_name>] 
{list=<focat_file_name>] 
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3e2e12 DISPLAY_GROUP_LIST % OGL 
tbrief ? full] 'f 
(status=riir2ir3iefi 3} 2 
3 
base i ba : This is the name of the file containing the & 
base source ftibrery. <Ailternatively a list of file names 5 
may be given to produce a combined group tiste tf this : 6 
parameter is not given an attempt is made to access a2 { 7? 
file with the name BASE. . 7 8 
9 
fist ! 4 3: This is the name of the file which receives 18 
the listing. If this parameter is not given, the file it 
name OUTPUT will be used. 12 
13 
brief t br i full fu 3: If the command inciudes§ the 14% 
BRIEF keyword or this ocarameter is omitted entirety, the 15 
display will contain onity the group namese If the FULL 16 
keyword is givens the group names as well as fhe decks 17 
associated with each group will be displayed. 18 
i93 
status ! st % See basic status concept. 28 
2i 
Examp te: 122 
SCU.DGL testo! 123 
. 2% 
25 
26 
2% 
28 
29 
38 
31 
32 
33 
34& 
35 
36 
37 
38 
39 
4&8 
&f 
&? 
&3 
4& 
4S 
4&6 
4? 
4B 
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3-3 MODIFICATIONS 


The folfowing commands together with the SCU editor are 
used to manipulate modifications to source tibraries. 


3e321 CREATE MODIFICATION $ CRM 


This command can be used to create the descriptive 
information to be associated with a modificatione 
Moditications are always created with state 0. 


create_modification moditication=<modification name> 
{feature=<feature_name>j 
{faut hor=<author_name_string>]} 
{description=<descriptive_string>} 
{base=<fite name>} 
tresult=<file_name>] 
istatus=riir2ir3tief ] 


modification i: mod 3 This 1 to 9 character fietd is the 
modification name. <Aiternatively a list of names may be 
given. 


feature i fe : This is ai to 31 character feature name 
to be associated with this modification. 


author ! au : This 1 to 31 character string can be used 
to identify the individual who wrote this modification. 


description ? de 3: This 1 to 256 character string can be 


used to describe the modification. It is suggested that 


this be used to point to official documentation for the 
modification such as psr numbers or desian documents. 


base {! ba : This is the name of the flte containing the 
base source tibrary. If this parameter is not given an 
attempt is made to access a file with the name BASE. 


resutt ior: This is the file to receive the modified 


source tlibrary. If this parameter is not givens the 
modified source library will be written to a fiite named 
RESULT « 


status ? st 3 See basic status concept. 


Examples: 
SCUslRM eo 
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mod=mymod ee 

fe=my_appearance ee 

au="M. Je Perreten*® e- 

de="short ,fats brown hair, beard® ee 
bar-oldfact e- 

r=newfact 


323.22 DISPLAY_MODIFICATION ? DIM 


This command disptays descrinptive information about 
modification. 


disotay_modification modification=<modification_name>tal! 
(name=<deck_name>} 
Cvase=<file name>] 
Tiist=<local_file_name>] 
Ttrief i full] 
{status=riir2irstief } 


modification ! mod ? ait 3 This is a 1 to 93  £4xc¢haracter 
modification name. Atternativety a tist of modification 


names may be given separated by commas and enclosed 


in 


parentheses or a range of modifications may be indicated 
by giving the first and last modification names separated 
by ellipses. Using the keyword ALL has the same effect 


as specifying the first and tast modifications on 
library as a range. 


the 


name % na ?: This is the name of adeck. If this 


parameter is specified, descriptive information witli 


be 


given about only tne named modification as it applies to 


this decke 


base ! ba 3 This is the name of the file containine 
base source (tibdrary. If this parameter is not given 
attemot is made to access a fite with the name BASE. 


the 


an 


jist : 1 3: This is the name of the fiie which receives 
the listing. If this parameter is not given, the fite 


name GUTPUT will be usede 


brief 3 br t full 2 fu & If the FULL keyword is incituded 
on this command, the descriotive information about this 


modification wif! be displayed as well as every tine 


of 


text aitered by this modification. If the BRIEF keyword 
is included or this carameter is omitted entire!fy, then 
oniy the descrinotive information about this modification 
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is displayed. 
status ! st 3: See basic status concept. 


Examples: 
scuedisolay_modification mod=05r123456 na=routineb ba=syspl es 
{i=fixforb full ’ . 


In this examotie the descriptive information about the 
modification named os5r123456 Is tisted on the file FIXFORB 
along with any lines altered by this modification in the deck 
routineb. 


COMPANY PRIVATE 


“26 48 we 
SO BwAW EW NO 


3-42 
CBC SOFTWARE ENGINEERING SYSTEM 
03/24/86 
ERS for Source Code Utility (NOS 170 Version) REVS J 
3.0 COMMANDS 
30303 CHANGE _MODIFICATION ? CHM 


30303 CHANGE_MODIFICATION ? CHM 


This command enters or modifies descrictive information 
about a modification. 


change_modification modificat ion=<modification_name>i{al} 


{feature=<feature_name>} 
fauthor=<author_name_string>] 
Tdescription=<descriptive_string>] 
{base=<filte name>! 
{resuit=<file_nane>] 
{state=<integer>] 
{status=riir2ir3iet] 


modification { mod i aft: This is a tt to 9 #£=character 


modification name. Aiternativety a tist of modification . 


names may be given separated by commas and enctosed in 
parentheses or a range of modifications to be changed may 
be indicated by giving the first and fast modification 
names separated by ellipses. Using the keyword ALL has 
the same effect as specifying the first and fast 
modifications on a tibrary as a range. 


feature i fe : This is a i to 31 character feature name 
to be associated with this modification. 


author { au 3: This 1 to 31 character string can be used 
to identify the individual who wrote this modification. 


description i? de ? This 1 to 256 character string can be 


used to describe the modification. It is suggested that. 


this be used to point to official documentation for the 
modification such as psr numbers or desicn documentss 


base 3? ba 3: This is the name of the fiie containing § the 
base source fibrary. If this parameter is not given an 
attempt is made to access a fite with the name BASE. 


result %! ro: This is the flie to receive the modified 
source tibrary. If this parameter is not given, the 
modified source {jibrary will be written to a file named 
RESULT. ; 


State : This is the new state for the modification. For 
a user to raise a modification to a giver state or f!ower 
it from that state to 0, he must have the corresponding 
authority over fhe base source fibrary or a higher onee 
Values this parameter may assume are? 
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Experimentai 
Developmental 
Stable 
Verified 
Released 


ANH 2 
os 88 66 se ab 


status { st 3: See basic status concept. 


Exampies . | 
SCUeCHM mymod de=“*short, fat, baid, beard® state=4 
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30324 PURGE MODIFICATION ? PUM 


This command is used to remove a modification from the 


source iibrary. In order to purge a modification a user must. 


have the appropriate authority for the library to manipulate 
modifcations at this state. One will not be afftowed to purge 
@ modification that is associated with the creation of a 
decks. Such decks must be purged first. 


purge_modification modification=<modification_name> 
iname=<deck_ name>] 
{base=<file name>] 
{result=<filte_name>] . 
(status=rlir2irsief) 


modification ! mod 3 This is the name of a modification. 
Alternatively a tist of modification names may be given 
separated by commas and enctosed in parentheses or a 
range of modifications may be indicated by giving the 
first and tast modification names separated by ellinses. 


name %$ na : This is the name of a deck. [If this 
parameter is givens onty the part of the modification 
that apolies to this deck will be removede Atternatively 
a list of names separated by commas and enclosed by 
parentheses may be given or a range of decks may be 
indicated by giving the first and tast deck names 
separated by ellipses. 


base ! ba 8s This is the name of the file containins the 
base source ltibrary. If this parameter is not siven an 
attempt is made to access a file with the name BASE. 


result i ro: This is the file to receive the modified 
source tibrary. If this parameter is not given, the 
modified source tibrary will be written to a file named 
RESULT. 


status 1? st 3: See basic stafus concept. 


Exampie: 
scuepurge_ modification fangs na=serpents ba=beasts r=animais 
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32325 SEQUENCE MODIFICATION 3 SEM 


This aliows a user to resequence a modification so that 
sequence numbers will appear in the order that source tines 
appear in the deck rather than in the order they were 
introducede This is onty attowed for modifications in state 
0. <All inactive tines introduced under this modification name 


wili be discarded. 


sequence_modification. modification=<modificat ion_name> 
iname=<deck name>} 
Cbase=<file name>] 
fresult=<file_ name>] 
{status=r1lir2ir3ief)} 


modification ! mod * This is the name of a modifica 
Aiternativeiy a list of modification names may be 

separated by commas and enclosed in parentheses 
‘range of modifications may be indicated by giving 


tion. 
given 
or a 

the 


first and tast modification names separated by eliinoses. 


name i nat This is the name of a decke if 
parameter is given, ontiy the part of the modific 


this 
ation 


which appties to this deck wiit be resequenced. 


Alternativety a tist of names separated by comma 
enclosed in parentheses may be given or a range of 


Ss and 
decks 


may be indicated by giving the first and tast deck names 


separated by ellipses. 


base ? ba 3: This is the name of the file containing the 
base source fibrary. If this parameter is not given an 
attemot is made to access a file with the name BASE. 
resuit {or 3: This is the file to receive the modified 
source ftibrary. If this parameter is not givens, the 
modified source ftibrary wiil be written to a file named 
RESULT. 


status i! st 3 See basic status concept. 


Exampies 
Scuesequence_ modification psri2345 
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320306 EXTRACY_ MODIFICATION ! EXM 

This command is used to extract a modification from a 
source library in the form of the editor commands INSERT, 
DELETE and REPLACE. 


extract_modification moditication=<modification_name> 


ecit_commands=<locai_file_name> 
iname=<deck_name>} 
{tase=<file name>] 
{scufupdate] 
tstatus=riir2ir3tef} 


modification ! mod : This is the name of a modification. 
Aiternatively a tist of modification names may be given 
separated by commas and enctosed in parentheses or a 
range of modifications may be indicated by giving the 
first and tast modification names separated by elt ipsese 


edit_commands % ec 3 This is the name of fhe iocal file 
to receive the edit commands generated by this commande 


name nas: This is a deck name. If specified cniy that 
part of the modification which applies to this deck wilt 
be written to the EDIT_COMMANDS fite. 


base {i ba ? This is the name of the file containing the 
base source library. [f this parameter is not given an 
attempt is made to access a file with the name BASE. 


scu i update : If the UPDATE keyword is specified the 


modification wit! be externalized as a six bit display 


code UPDATE correction set containing *BEFORE, * INSERT 
and *DELETE directives. If the SCU keyword is given or 
this parameter is omitted entirely, the modification wil} 
be externalized as the ASCII SCU editor commands INSERT» 
DELETE and REPLACE. 


Status i st 3: See basic status concept. 


Examp tes 
scueextract_ modification fred ec=comfile ba=pets 
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3e3e7 OISPLAY_MODIFICATION_LIST § DML 


This command displays a tist of al! the modifications for a 
source library. 


disptay_modification_tist [(base=<fite_name>j 
{tist=<ltocal_file name>] 
tbriefifult 
istatus=rilir2irsief } 


base } ba 3 This is the name of the file containing the 
base source tibrary. If this parameter is not given an 
attempt is made to access a file with the name BASE. 


list ? ( 3 This is the name of the fite which receives 
the ftisting. If this Pergeet ec: is not givens the file 
name OUTPUT will be usede 


brief i br ? fuli i fut If the BRIEF keyword Is Inctuded 
on the command or this parameter is omitted a shorter 
dispiay wilt be givene ff the FULL keyword is voresent a 
more detaifted display wilt be gqiven. Currentiy the 
displays setected by the two keywords are identical. 


status ! st 3 See basic status concept. 


Examptes 
SCU.eDML tibrary modtist 


3e3e28 DISPLAY FEATURE % DIF 


This command is used to produce a modification descrintion 
for each modification associated with a feature. 


display_feature feature=<feature_name> 
{base=<fite name>] 
Ctist=<ltocal_fite_ name>] 
{brief ! fult} 
{status=riir2irsiefi 


feature 3 fe 3 This is the name of the feature to be 
disotayede 


base ? ba % This is the name of the fite containing the 


base source tibrary. If this parameter is not given an 
attemot is made to access a fite with the name BASE. 
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iist ? t 3 This is the name of the fite which receives 
the tisting. If this parameter is not givens, the file 
name OUTPUT will be used... 


brief ft br i full i fu 3 If the BRIEF keyword is inciuded 


on this command or this parameter is omitted entirely, 

the display wit! inciude only a tist of the modifications 

associated with the feature. If the FULL keyword is 

used, the display will give the modification descriptions 
for each of these modifications as weli. 


status i! st : See basic status concept. 

Examples 

scuedisplay_feature enhanced_network_interface 

303.9 DISPLAY_FEATURE_LIST ! OFL 

This command oroduces a ftist of afl feature names for a 

source library and optioneltty a tist of which modifications 

are associated with each. 

disptay_feature_list (base=<file_ name>] 
Tlist=<tocat_file_name>] 
{trief ? futt? 
tstatus=rtiir2irgief 


base 1 ba 3: This is the name of the fite containing the 


base source fibrarye If this voarameter is not given an 


attempt is made to access a fite with the name BASE. 


fist H 1 3 This is the name of the fite which receives 
the tisting.e. If this parameter is not givens the file 
name OUTPUT will be used. 


brief 1 br %t full 1} fu % If the BRIEF keyword is included 
on this command or this parameter is omitted entirely, 
onty the tist of feature names for this source library 
will’ be displayed. If the FULL keyword is used, iists of 
the modifications associated with each feature will be 
inctuded as wetie 


status ! st 3 See basic status concept. 


Examp ies 
scuedisolay_feature_fiist myop! 
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304 CONYERSTON AIDS i 
2 

Two commands are availabie to convert source code from 3 
UPDATE and MODIFY program tibrary format to SCU source tibrary ' & 
formate Update and Modify names which do constitute valid Stu : 5 
names can be preserved as wil! sequence information. Afi ? 6 
modifications are set to 0 fexperimentail) state. This is done : 
to allow a user the opportunity to add descriptive information i; 8 
to key modifications. On conversion *WEOR directives will be i 9 
changed to *WEOP directives. Because only one ftevel of file 118 
separator will be supported under NOS/VE, the *WEOF directive 712 
will be changed to a *WEOP directive as weil and the user wif! $12 
be informed. 813 
A command is avaiiabie to convert source code from SCU 14 
source tibrary format to UPDATE program tibrary formate. With 15 
the exception of name substitution, sequence information witt 316 
be preserved. . . | 117 
Deck names or correction identifiers which do not qualify 18 
as vatid SCU deck or modification names wiil be flagged as 819 
errors and the user will be expected to effect name 729 
substitution during a subsequent attempt at conversion. Put i248 
another ways these conversion utiliities witli reject names that 122 
do not begin with a ietter or $. 123 
During conversion a euser may wish to make nane {26 
substitutions either because existing names on the UPDATE or 125 
MODIFY tibraries may not qualify as SCL names or because he 726 
wishes to use the tonger names aliowed by SCU. The conversion 227 
utilities aitow for name substitution through the NAME_LIST i28 
file. Each tine in this fite is interpreted as the parameters 1293 
of a SCL command as shown betow? 338 
34 

nos_name=<update_or_modify_name> 132 
(sci_short=<modification_name> ] . 733 
tiscl_tong=<deck_name>i<define_name>] 136 

35 

nos_name : This is a the name of an UPDATE or MODIFY $36 
deck, correction identifier or DEFINEd namee The _yser {3% 
should specify this parameter with the keyword if the 136 
nane_ r r ther than letters, digits and 339 

Se 148 

&T 

sci_short & This is a1 to 9 character SCU modification 142 
Namee 743 

G&G 

sci_iong & This is a i to 31 character SCU deck name or 145 
DECLARE name (see criteria fiie directives). If this $46 
parameter is omitted the value given for SCL_SHORT wilt 147 

be used. If a vatue is not given for at feast one of the 348 
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parameters SCL_SHORT or SCL_LONG an error witli be if 
reported and conversion inhibited. 1 2 
Exampies {4 
dsd dsd dynamic_disptay_driver 7 6 
zscmere scm$ere scm$replace _ ; 6 
nos_name=old=fool ofd_ fool i ¥ 
| : 8 
On the first tine the MODIFY name DSD wit continue te be :; 9 
used on SCU as fhe modification name associated with tines 118 
introduced under that name, but the deck name will have the 712 
tonaer, more descriptive forme On the second fine a MCDIFY. 112 
deck name is being changed to fit the NOS/VE naming patterns 113 
On the third tine the name OLD=FOCOL is being changed toa 918 
OLD_FOOL to make it a ftegaf SCL name. 115 
16 
17 
18 
Se4ei CONVERT_UPDATE_TO_ Seu $ cuts 13 
. 28 
This command converts an UPOGATE orogram ere to an scu 2t 
source jiibrary. 22 
28. 
convert_update_to_scu [foldpi=<tocali_fiile_ name>} 12% 
{resutt=<fite name>] 125 
fiist=<local_fiie name>] | 26 
iname_list=<tocai_ file name>] 2F 
{orief &t full] 28 
fascii64 %t ascii81i2} 23 
{criteria=<iocat_fiite_ name>} 330 
{status= riir2ir3ief} 332 
32 
otdp!t 3: This is the name of a fite containing an UFDATE 33 
program tibrary in sequential format. If this parameter $34 
is not given an attempt witt be made to access 3 locat 335 
file with tne name OLDPL. 136 
37 
resulf iro: This is the file to receive the new source 738 
fibrarye If this parameter is not givens the new source 339 
fibrary wilt be written to a file named RESULT. 149 
&Y 
&2 
tist 1.1 3 This is a fite to receive a report describing 143 
the conversion. The default vafue for this parameter is 144% 
OUTPUT. 145 
&6 
name_tist ! nt 3 See discussion of name substitution 247 
abovee 1488 
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brief i bor ft full ? fu 3 If the BRIEF keyword is inciuded 
on the command or this parameter is omitted, a shorter 
form of the tisting will be produced. If the FULL 
keyword is used a more detaited tisting wiit be 
producede 


ascii64 3 ascii81i2 * These aiternate keywords inform the 
conversion routine whether the input program tibrary is 
in the 64 character set or full ascii. ASCII812 Is 


seiected if neither keyword is givene Currentiy the 
conversion. .from. ASCII update _(ASCII812) is. not 
imolementede 


criteria tcr : This is the name of a fite to receive 
criteria file directives which will preserve a oart of 
the information from the YANK$$$ deck on the UPDATE 
program tibrary. Active YANK*s witli be converted to the 
corresponding EXCLUPDE's. Active DEF INE*s wilt be 
converted to DECLARE‘s. Inactive cards in the YANKSS$$ 
deck wiil be ignored. [If this parameter is omitted the 
contents of the YANKS$$ deck wil! be ignored. 


status ! st 3: See basic status concept. 


Exampie: 
scueconvert_update_ to_scu piia scuptia saga ascii64 


3e4e2 CONVERT_MODIFY_TO_SCuU i CMTS 


This command converts a MODIFY program tibrary to an SCU 
source tibrary. 


convert_modify_to_scu fopi=<local_file_ name> J 
{result=<filte_name>] 
Ciist=<iocal_file_name>} 
{name_tist=<iocal_filte name>] 
Corief ¢! fulll 
Cascii64 1 ascii6oi2i 
(criter la=<tocal_file_ name>] 
{status=rlir2irsietf) 


opi 2 This is the name of ae fite containing a “eDIFY 
program tibrary. If this parameter is not given an 
attemot is made to access a tocat file named OPL. 

result iro: This is the file to receive the new source 


COMPANY PRIVATE 


oo MO) UT I ne 


3-52 
CDC SOFTWARE ENGINEERING SYSTEM 


. 03/24/80 
ERS for Source Code Utility (noS 170 Version) REV? J 
3.20 COMMANDS 
3e4%2.2 CONVERT _MODIFY_TO_SCU ? CMTS 
fibrary. If this parameter is not givens the new source 74 
1ibrary wili be written to a file named RESULT. 3 2 
3 ; 
& 
fist 32 1 3: This is a file to receive a report. describing i5 
the conversion. The default value for this parameter is 16 
OUTPUT. 1% 
. 8 
name_list i ni.: See discussion of neme substitution. i 9 
above. $18 
11 
brief ? br i full % fut If the BRIEF keyword is included 12 
on this command or this varameter is omitted, a shorter 13 
fisting will be produced. If the keyword FULL is 14 
inciuded a more detalied listing will be produced. 15 
16 
ascii64 1 ascii612 2 These alternate keywords inform the 17 
conversion routine whether the input program library is i8 
in the 64 character set or full ascii. ASCII6i12 is 19 
seiected if this parameter is omittede 26 
2t 
criteria ! cr 8: This is the name of a fite to receive 122 
criteria file directives. As an example, modifications 123 
flagged as yanked by MODIFY wiltt be entered into the 24 | 
criteria file as EXCLUDE_MOD directives. 125 
26 
status ? st % See basic status concept. a 
28 
Example: 129 
scueconvert_modify to _scu relia scuta saga ascii64 138 
34 
32 
3ehe3 CONVERT_SCU_TO_UPDATE 3 CSTU 33 
. 3% 
This command converts an SCU source ftibrary to an UFDATE 135 
program tibrary. Ihis command is not currentiy implemented 136 
and. the requirement for such 3 command is under reviews sh 
convert_scu_to_update {base=<file name>} 139 
inewot=<tocal_file_name>] | 148 
Ciist=<locali_file name>] re 
{name_list=<iocal_ file name>] 42 
forief {! full] &y 
{ascii8i2 i ascii64} && 
{criteria=<tocai_file name>] 746 
istatus=ritir2ir3iefi 146 
a? 
base ? ba : This is the name of a file containing an SCU 48 
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source library to be converted. If this parameter is not. 


given an attempt witit be made to access a fiite named 


newplt 3: This is the file to receive the new UPDATE 
program tibdrary. If this parameter is not givens the new 
program tibrary witt be written to a file named NEWPL. 


fist ? 1 2? This is a fite to receive a report describing 


the conversion. The default value for this parameter is: 


OUTPUT. 


name_list 3 nti 2 See discussion of name substitution 
above. 


brief ! br 1 full { fu 3 If tne BRIEF keyword is included 
on the command or this pararmeter is omitted, a shorter 
listing wilt be produced. If. the FULL keyword is 
inctuded a more detailed iisting wili be given. . 


ascii8i2 71 ascii64 3 These aiternate keywords inform the 
conversion routine whether the output program tibrary is 
in the 64 character set or full asciie ASCII812 is used 
if this parameter is omittede 


criteria icr : This is the name of a criteria fife. 
DECLARE directives will aovnear as *DEFINE directives in 
the YANKS$$ deck on NEWPL. EXCLUDE directives witt 
appear as *YANK *SELYANK and *YANKDECK directives. 


status ' st 2 See basic status concept. 


Exampie: 
scueconvert_scu_to_update scuptia olia myth 
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325 CALLING THE EDITOR 


The command described in this section is used fo call 


3=+5% 


the 


editor. Att commands wilt be interpreted as editor commands 
until one exits the editor. The editor can be used in either 


batch or interactive mode. 


3e5eil EDIT 


This command establishes an environment for fhe other 
editor commands. 


edit modificat lon=<modification_name> 
{base=<file name>] 
tresul t=<file_ name>} 
CLinput=<tocai_fite_ name>] 
{list=<iocai_ file name>} 
{Iname=<deck_name> ] 
{continue} 
{status=rtLir2irgief } 


modification H mod : This is the name _ for 
modification being introduced or attered. 


tine 


the 


base ! ba 32 This is the name of the fite containing a 


source fibrary containing one or more decks’ to 
editede If this parameter is not given an attempt 
made to access a fite with the name BASE. 


be 
is 


result ir 3: This is the name of the fite to receive the 


modified source iiborary. If this is not given 


the 


modified tibrary witi be written to a file named RESULT. 


inout ? i : This is the name of the file from which 
commands are to be read. The default vatue is INPUT. 


edit 


list 3 i ? This is the name of the fite which receives 


the tistina. If this parameter is not civens the 
name OUTPUT will te used. 


file 


name i na 3: This is tne name of the deck to edit first. 


continue ? con 2: If this keyword is presenf, the editor 
witl attow the user to add to an existing modification in 


state 0. 
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status i st &: See basic status concept. 


Exampie: 
scueedit improve oldp! continue 
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3-6 GROUPING SCU_ COMMANDS 


Alt though SCU commands are availabie as separate job controt 


statements that may be used entireiy independently of one 
another, it is often desirable to associate them with one 
another to make a series of changes to a base source tibrary 
and produce a single resuit source ftibrary and listabie 
output. This is done by using the GROUP and END commands. 


3e60e1 GROUP 


Tnis command is used to flag that following SCU commands 
are to be associated with one another and to assian default 
values for the names of some of the files that these commands 
must accesse When this command is used the base source 
fibrary is copied to a working copy. Subsequent SCU commands 


uSing the default base source tibrary wii! modify this working. 


copye Using the END command causes the working copy to be 
written to the result source library. Nondefautt base and 


result source {tibraries may be named explicitiy on individuat- 


commands. 
- Permanent files named on the BASE and RESULT parameters on 
the GROUP command will remain tocai until the corresponding 


END command is executed. The commands !isted above under. 


conversion aids should not be used in group mode. 


group (base-=<file_name>} 
{result=<fite name>] 
{iist=<tocal_file_name>] 
{status=riir2ir3ief] 


base ! ba 3 This is the name of the fite containing the 
base source ftibrary. [f this parameter is not given an 
attemot is made to access a file with the name BASE. 


result {rt This is the file to receive the modified 


source tibrary. If this parameter is not given, the 
modified source library will be written to a fite named 
RESULT. 


list 4 | ? This is the name of the file which receives 
the tistinge If this parameter is not givens the file 
name OUTPUT wiil be used. 


Example? See exampte below under end. 
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3e6e2 END 


This command causes the working copy of the source library 
to be written to the result source library fife and any 
subsequent SCU commands to operate independentiy of one 
another. 


end (status=<status_variabie>] 


Exampie: scuegroup ofdiib newlib ist0212 
scuedispiay_library full 
attachsetextfo. 
scuecreate_deck ((fetch_parametfers,textfo)) 
fetch _p g=scu . 
scuecreate_ modification mod_to_4& au=*Me Je Perreten*® 
de="*Adds syntax check.* 
scueedit mod_to_4& continue i=edcoms. 
scuedispltay_tibrary atterna t=altlist 
scuechange_modification axte state=%4 
scuedispiay_library full 
scueend 


In this exampie the GROUP command dectares that the SCU 
commands that follow will be associated with one another. 
OLOLIB is the fite which contains the base source tibrarye 
Alt changes to this base are accumulated on a working copy and 
wiff_ be written to the result source tibrary NEWLIB when an 
END command is encountered. ODisplays will be written to the 
file LST0212 untess another tist file is explicitiy named on 
an individual command. 

The first DISPLAY_LIBRARY command gives a deteiled 
description of the original source tibrary. 

The attach of file TEXKTFP is shown to ittustrate that other 
commands can be intermixed with SCU commandse 

The CREATE_DECK command creates a new deck on the working 
copy of the source ltibrary using the contents of fite TEXTFP 
as the initial texf. 

The CREATE_MODIFCATIGN command creates a new modification 
on the working source tlibrary. 

The EDIT command caits the editor to perform the edit 
commands from fite  EDCOMS on the working copy of the source 
library. Lines introduced by this session will be part of the 
modification mod_to_4.e | 

The second DISPLAY LIBRARY command is inctuded to emphasize 
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that individual commands can exptlicitiy name aiternate § fites 
to manipuiate. 


The CHANGE _MODIFC &éTION command raises the state of 


modification axie on the working source library to state 4& 
(released). 


The last DISPLAY_LIBRARY command gives a detailed 


description of the working source library after ati the 
changes introduced by the entire block of SCU commands. 

The END command causes the working source fibrary to be 
written to the result source tibrary on file NEWLIB and = flags 


that subsequent SCU commands will execute independentiy of one 


another. 
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Directives are avaitabte to the SCU user tc assist him in 
defining the contents of an expanded text file. These are 
text embedded directives intermixed «ith the source data and 
criteria file directives. This section describes both types 
of directives and their interaction with one another. 


4ei TEXT EMBEDDED DERECTIVES 


A text embedded directive (TED) witli be recognized by the 
eccurrence of a key ocharacter as the first character of a 


source line fottowed immediately by a keyword. 


encountered the normai expansion will 
mannner soecified by the particular TED. 


If a TEB is 
aitered in the 


While orocessing the EXPAND_DECK command, TED"s are 
processed and they are not copied into the expanded text 


file. While processing the EXTRACT_DECK 


command, TED"*s are 


not processed and are written to the the extracted text file. 


beleit COPY 


This directive must be followed by a 


deck names This 


directive wiit copy the text of the specified deck inte the 
expanded text file. The same search order will be used as for 


decks fisted on the EXPAND_DECK command. 
deck that copies another deck and so on 


sequence is not recursive. 


*copy name=<deck_name> 


name i na : This is the name of a deck. 
list of names may be given separated 


enciosed in parenthesese 


Exampie: *copy deckt 


A deck may copy a 


tong as the 


Aiternatively a 
by commas and 
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Geie2 COPYC (COPY CONDITIONAL) 


This directive serves the same function as COPY except that 
the text of the deck is written to the expanded text file 
conditionatty. In other words, if fhe specified deck has been 
copied into the expanded text file for the deck currentty 
being exnoanded, if will not be inctuded againe 


¥copyc name=<deck_name> 


name Ina? This is the name of a deck. Alternativety a 
{ist of names may be given separated by commas and 
encitosed in parentheses. 


Examptes *copyc deckli 


belied DECK 


This text embedded directive witli only be interpreted as 
such when if occurs as the first iine of a partition (record 
on NOS 170) in the file named by the NAMES_CN_FILE parameter 
of the create deck commande. [fs purovose is to provide the 
deck name for the following text tines. 


*deck name=<deck name> {fexpandino_expand] 


name ? na : This is the name to be given to the deck 
which wilt contain the text tines that foliow the 
directive. 


expand 12 exp % no_expand ! nexp 8: [If the NO_EXPAND 
keyword is included on the directive this deck wit! only 
be written to the expanded text file oroduced by the 
EXPAND_DECK command as a resuit of processing the text 
embedded directives *COPY and *COPYC. If the EXPAND 
keyword is inctuded or this poarameter is omitted 
entiretlys this deck wil! be written to the expanded text 
file by the EXPAND DECK command whether named on the 
command or on the *COPY and *COPYC directives. 


Heiee ELSE 


This optional directive may be used to separate fines of 
source data that are to be expanded if the given condifion is 
true from those expanded if it is faise. Either of the blocks 
between the IF and the ELSE or between the ELSE and the IFEND 
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2 
3 
4eieS IF & 
5 
This directive is used to allow source fines to be written & 
to the expanded text file conditionailty. If the specified 7 
condition is true, the source fines between this directive and : in| 
the next ELSE or IFEND directive (whichever occurs first) wit 7; 9 
be written to the expanded text fitee Text embedded 110 
directives in the same range wiltt be processed while 1f 
processing the EXPANO_DECK command. If an ELSE directive is 12 
present before the IFEND the source lines between those two 13 
directives will be skipped as wel! as anv text embedded 16 
directives. 15 
16 
{If the specified condition is faise, source tines and text 17 
embedded directives wiil be skipped until either an ELSE or 18 
IFEND directive is encountered. Source lines and text 193 
embedded directives between a foltowing ELSE and IFEND will be 28 
processede Normait  (Cunconditional) processing resumes 2i 
following the IFEND whether the condition is true or false. 22 
23 © 
There are two forms of this directive shown below. 26 
25 
*if $scu_type (name, type) 26 
27 
28 
name 3: This is a name to be checked for the 29 
attribute described in the type ftietd. 38 
; 3i 
type : This fietd is used to specify one of three 332 
keywordse Any of these keywords may be prefixed by 133 
NOT. The keywords ares i34& 
. 35 
DECK This Is a name of a deck on any of the 236 
fibraries specified by the BASE 13? 
parameter. 138 
39 
MOD This is the name of a modification to any 148 
of the tibraries specified by the BASE 14% 
parameter. 142 
43 
DECL This is a name defined by a DECLARE && 
directive on the criteria file associated &S 
With this EXPAND _DECK command. 4&6 
G¥ 
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Exampie: *if ¢scu_type(dsd,deck) 


These source tines are expanded if dsd 
is a deck name. . 
¥else 

These source tines are expanded if dsd 
is not a deck name and these source 
fines are skipped if dsd is a deck namee 
*ifend 

Unconditional processing resumes with 
these source tines. 


FExampie 2: *if %scu_type(fix2,notmod) 


These tines are expanded if there is no 
modification to the source tibrary with 
the name fix2. 

*ifend 


*if $roinamesvaiue) 


name 3? This is a name defined by a DECLARE directive 


on the criteria file associated with this 
EXPAND _DECK command. Testing a name that is not 
DECLAREd wilt cause an error. 


ro °: This is ae retationat operator. acceptable 
values ares: 


ot : Greater than. 

ge : Greater than or equal to. 
it 2 Less than. 

te : Less than or equal. 

eq 2 Equal fo. 


ne 3 Not Equal to. 


vatue : This is a positive decimal value between 


and 65535. 


Exampies *if $ne(fritz,35) 


These fines will be expanded if the name 
fritz has any vatue other than 35. 
¥ifend 


Conditional biocks may be nested to a maximum depth of 32 
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fevels with the restriction that every IF must have a matching 
TFEND within the same deck. 
40126 IFEND 

This directive marks the end of a biock cf source text to 
be expanded conditionally. An IFEND must occur in the. same 
deck as the corresponding IF. 


Gele7 TEXT 


This directive may te used to indicate trat the following 
biock of source data is to be considered as text. In other 


words no scan wilt be made for text embedded directives except . 


for TEXTEND. 


hee TEXTEND 


Tnis directive teiis SCU to resume scaning source data for 
text embedded directives. 


&eile9 WEOP 


Tnis directive witi cause an end of partition to be written 
on the file receiving the expanded text. {In the NOS 176 
imptementation of SCU, an end of record wilt be written.) 


4$ei.2i0 WEOPC 


This directive will cause an end of partition to be written 
to the file receiving the expanded text, if any source data 
has been written to the fiie since the tast separator. (In 
tne Cyber 170 impoptementations an end of record wil! be 
written.) 
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4&2 CRITERIA FILE DOITRECTIVES 


These directives are availabte to altiow the SCU user to be 
more selective about what source data is written to the 
expanded text file. They are given on a separate fite and are 


not preceded by a key character. They are orocessed in 
of occurencee 


&e2ei DECLARE 


erder 


This directive is used to define a name with a vatue 
associated with if that can be used in connection with the IF 
text embedded directive to conditonality inctude source data on 


the expanded fext file. 
deciare name =<name> {vafue=<integer>] 


mame $? nai This is a1 to 314 character name. 


value : This optional parameter is an integer in the 
range 0 to 65535 decimat. If this is omitted the vaitue 0 


is assigned. 


Exampies deciare fritz 35 


4&e2e2 EXCLUDE DECK 


This directive can be used to explicitiy exclude r= 
particular deck from being written to the expanded text file. 


exclude _deck name=<deck_ name> 


mame {na 2 This is the name of a deck to be exciudeds 
Aiternatively a list of names separated by commas and 


enclosed by parentheses may be given or a3 range of 


cecks 


may be indicated by giving the first and tast deck names 


to exctude separated by ellioses. 


he2e3 EXCLUDE_FEATURE 


This directive is used to exciude incomplete or unstable 


features from an expanded text fite. 
exclude_feature feature=<feature name> {state=<integer>! 
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feature i fe : This is the name of a feature to exclude 
when generating an expanded text file. Aiternativety a 
list of features may be given separated by commas and 
enclosed in parentheses. 


state 3 This parameter may be given as one of five 
integers 0-% 

(see states in the concepts section). Ai modifications 
which are part of this feature which are at or below the 
given state will tbe exctuded from the expanded text 
file. If this parameter is omitted att modifications 
associated with this feature will be excludede 


Example? exctude_feature new_network_interface 0 


e204 EXCLUDE GROUP 


This directive is used to exctude an entire group of 
retated decks from the expanded text fite. 


exciude_group group=<group name> 


group {gg 2? This is a 1 to $31 character group =namee 
Alternatively a fist of group names may be_ given 
separated by commas and enctosed in parentheses or a 
range of groups may be indicated by giving the first and 
fast group names to exctude senarated by ellipses. 


te2e5 EXCLUDE MOD 


This directive can be used to exctude the effects of a 
particular modification. 


excltude_mod _ modification=<modification_name> oe 
Tname=deck_name] 


modification %! mod 3 This is the name of a modification 
to be excluded from the expanded text file. 
Aiternativelty a tist of modifications may be given 
separated by commas and enctosed in parentheses. 


name ina: This is the name of a deck. That part of the 
modification which arcplies to this deck will be exctuded 
on the expanded text file. <Aiternatively a tist of deck 
names may be given separated by commas and enctosed in 
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parentheses. 


Examples: exciude_mod newmethod obsotete_deck 


4e2e6 EXCLUDE _STATE 


This directive is used to exclude the effects of ai? 
modifications at or below a given state. 


exciude_state state=<integer> 

state : This parameter is given as one cf the integers 
Ge2e? INCLUDE_COPYING_ CECKS 

This directive causes al! decks which copy a named deck to 

be written to the expanded text fite. Chains of indirect 
references will be followed until decks with the EXPAND 
attribute are found. 
inctude_copying_decks name=<deck_name> 

name ! nas: This is a deck names As on the EXPAND_DECK 

command the name parameter may be given as a list or 

range of decks. 


4#e2e8 INCLUDE, DECK 


This directive is used to specifcaltiy inctude a particular 
deck on the expanded text file. 


include_deck name=<deck_name> 
name 7% na? This is a deck name. As on the EXPAND_DECK 
command the name parameter may be given as a tist or 
range of decks. 
&e2e9 INCLUDE_FEATURE 
This directive is used to inciude ail the modifications 


associated with a feature which are at a given state or higher 
on the expanded text file. 
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inciude feature=<feature_name> [{state=<integer>] 


feature {! fe 3: This is the name of a feature to be 
included. <Aiternatively a list of features may be given 
separated by commas and enctosed in parentheses. 


state ?: This optional parameter is given as one of five 
integers 0-4 (see states in the concept section). Tf 
this parameter is omitted ati modifications associated 
with this feature wilt be included. 


Exampie? inctude_feature new _network_interface 3 


&e2e10 INCLUDE_GROUP 


This directive is used to cause an entire croup of retated 
decks to be inctuded on the expanded text fiie. 


include_ group group=<group_name> 


group i 9g 2? This is ai to 31 character group name. 
Alternatively a tist of group names may be given 
separated by commas and enciosed in parentheses or 2 
range of groups may be indicated by giving the first and 
last group names to include separafed by ellipses. 


Ge2eli INCLUDE_MOD 


This directive is used to explicitty inctude a modification 
in the expanded text fite. 


inciude_mod modif ication=<modification_name> ee 
{name=<deck_ name>] 


modification 1% mod 2 This is the name of a modification 
to be incifudede Aliternatively a list of modifications my 
be given separated by commas and enctosed in 
parenthesese 


name ?{ na? This is the name of a deck. If this 
parameter is given onty that voart of the modification 
that applies fo this deck will be included. As on the 
EXPAND_DECK command the name parameter may be given as a 
list or range of deckse 


Example? incilude_mod accounting_fixes 
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Ge2ei2 INCLUDE_STATE 


This directive is used to inctude the effects of alt 
modifications at or above a given state. 


inctude_state state=<integer> 


state 3: This parameter is given as one of the integers 
0-4. 
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520 SCU EDITOR 


The SCU editor provides the capability of generating and 
manipulating source text. It operates on fites in source 
tibrary format allowing source tines to be introduced or 
corrected either interactively or in batch mode. 


Sel EDITOR CONCEPTS 


This section introduces some concepts that are used in the 
SCU editor. <Atthough most of the terms area not new they may 
have particular meaning in the SCU context. 


5Seiei TABBING 


The TAB command defines a tab character and associated tab 
columns. Ofher commands which invotve inserting text scan the 
inserted text for the tab characters When the tab character 
is encountered, spaces are inserted into the text from that 
point up to the next tab cotumn where the next character is 
piacede The tab character is not piaced in the ftibrary texte 
Cne can define a default vatue for the tab character and 
coiumns in each deck header. 


One tab character and up 256 associated tab columns can be 
active at one time. 


Sete2 LINE IDENTIFIERS 


Each jiine within an SCU tibrary is assigned a tine 
identifier which is unique within a decke This identifier 
consists of the i to 9 character modification name and a six 
digit sequence number. The sequence number witi start from f 
as the first tine introduced under the modification in a deck 
and increment by 1 as tines are added. Continuing a 
modification wit! resutt in sequence numbers starting t 
greater than fhe last previously introduced to this decke 
Sequencing starts from 4 in each deck rather than being 
continuous throughout the source itibrary. To reference a tine 
by tine identifier one cives the modification name separated 
from the sequence number by a period. Trailing bianks in the 
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modification name and teading zeros in the sequence numbers 
wili have no significance. 


Seie3 KEYWORD VALUES 


On some editor commands, tines or position within aie deck 


may be given through the use of keywords. These Keywords and 
their short forms are tisted below. 


AlL 7 A & This indicates ali active tines in an StU 
deck. 


FIRST 2? #F $3: This indicates the first active tine in an 


SCU deck. 


LAST $ L 3 This indicates the iast active tine in an StCU 
decks | 


CURRENT : C2: This indicates the current active tine in 
an SCU decke 


On those tine editor commands using the number parameter § the 
keyword below can aiso be used to specify a vatue. 


ALL 1 A & This specifies every active tine in a range. 


On those tine editor commands using the occurrence parameter, 
the keyword below can be used to specify a vatue. 


LAST 3 L 3 This specifies the last occurrence of the tine 
or biock.e 


On the DECK command a deck to be edited can be selected by 
Giving a deck name expticitty or vy the use of the keywords 
below. 


FIRST : This keyword setects the first deck in the 
directory on the tibrary as the object of the commands 
which foltow. 


LAST $: This keyword selects the tast deck in the 
directory on the tibrary as the object of the commands 
which follow. 


NEXT : This command selects the next deck in the 
directory on the tibrary as the object cf the commands 
which follow. 
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Sele WIDTH 


Width is a maximum number of characters to be alicwed in 2 
text line. Line overfiow occurs if the user causes a line to 
be longer than the width declared. The editor issues a 
warning message and allows the overfiowing line to be added or 
altered. It is the user*s responsibitity to split ionger 
fines where necessarys 


5eieS THE BATCH USER 


The SCU tine editor will in some cases discriminate between 
batch and interactive users. The VETO option on commands wilt 
not be availabie to batch users. Further restrictions on 
which commands and options are available to the batch user may 
prove desirabie. For example, tocating or aititering source 
tines by matching text strings alone may tead to ambisuity 
which is readily apparent when editing interactively but may 
cause serious problems when entering corrections in batch 
modee 


$2126 UNIT 


Some of the tine editor commands use as a parameter the 
UNIT keyword, which has the short form UN. When this orction 
is seitected a text string will be considered a match with that 
given on the command onty if it occurs as a unit. that is if 
is surrounded by characters other than those alftowed in an SCL 
namee The most common exampie of this is to search for a 
character string that is enctosed in a pair of bianks. 


Seie7 VETO 


Some of the iine editor commands that involve text or 
source tine atteration atliow the keyword parameter VETO which 
has the short form Ve. If this parameter is specified, the 
first and tast line of each group to be altered will be output 
foltowed by the query “CHANGE?™, “DELETE?” or “REPLACE?™ 
depending on the command. [In the case of the CHANGE command 
the candidate tine witli be shown with the next string 
substitution aiready in effect. The user may make the 
following responses to fhe query: 


NO !N 3 This causes the current group reptacement to be 
skipped. 
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QUIT % @Q 23 This causes the command to terminate with no 
further replacements. 


CONTINUE 1 C 3 This causes veto mode to be ended. The 
current and any subsequent reptacements will occuf. 


Yes 3? Y 3? This causes the current group reptacement to 
take piace. 


Any other response causes the query to ce repeated and 
veto mode to remain in effect. 


501.28 END OF LINE BLANKS 


The SCU editor detetes trailing blanks on input. For the 
sake of matching character strings during searches’ tines 
appear to be blank padded to “width™ characters. 


5ei-e9 TERMINAL INTERRUPTS 


Under [AF on 170 either user break 1 or user break 2 wil t 
have the same effect on the editor. If either is received 
while displays are being sent to the ferminal the remainder of 
the output will be discarded and the editor wit! wait for a 
new command to be entered. If either is entered white the 
editor is waiting for a response to the veto query described 
above the editor will resvond as if the user nad entered 
QUIT. If either is entered white the editor is accepting text 
input, text inout mode will be ended. In the tast case an 
additional carriage return will be required before the user 
will be abte to continue. 


5e1ie10 REPLACEMENT TEXT 


On the INSERT snd REPLACE commands described teitow 
replacement text may pe supplied in three different ways each 
indicated by the use of a different keyword. Tab characters 
are processed regardiess of the origin of the repniacement 
text. Lines introduced wit! have line identifiers consisting 
of the current modification name and consecutive sequence 
numbers starting from the current value of the sequence number 
for this modification. Tne reniacement text parameter is 
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described betow: 
funtil=diwith=t3ifile=<tocal_file_nane>) 


until = us When the keyword UNTIL is used, reptacement 
text is read from the edit command input fite. The one 
character string given as the vaiue of this parameter 
specifies the delimiter marking the end of the text to be 
inserted. The delimiter is only interpreted as such when 
it is the fast character on a line. The delimiter is not 
considered part of the entered text. 


with ¢? w 3: When the with keyword is used, the string 
given as the vaiue for this parameter is used as the 
replacement text. 


file $3 f 2 When the file keyword is used, replacement 
text is read from the named file. If the keyword FILE is 
used and no vatue is given an attempt is made to access a 
file named MERGE. When this keyword is used the keywords 
betow can be used as the second value of a vaiue set for 
this parameter. 


rewind 1 r i rewind_before ? rb ! rewind after 1! ra 
$ no rewind ? nr These keywords specify positioning 
to be done on the file. Default is REWIND_BEF ORE. 


Default values are assigned as foltows. If the the 
vatue of this parameter is given positionalty, if is 
assumed to be a vatue for WITH. If this parameter is 
omitted entirely the command witli be processed es if 
UNTIL="°/"* had been specified. 


5e2 EDITOR COMMANDS 


The SCU tine editor commands emptoy a syntax simitar to 
that proposed for NOS/VE System Command Language (SCL). there 
ranges are indicateds such as first and tiast tines tec be 
listed, the two values are separated by ellipses. Items shown 
in brackets are optional and those nested in brackets within 
brackets are an optional part of an optional item. 


The short form for aecommand is given with the command 
where one is avaiiable. 


COMPANY PRIVATE 


~~ 
io Oo GoW OS UT Gd IN pe 


5-6 
CDC SOFTWARE ENGINEERING SYSTEM 


03/24/7830 
ERS for Source Code Utility (NOS 170 Version) REVtJ 
5.0 SCU EDITOR 
Se22i CHANGE ? C 
Se2eil CHANGE ? C F | 
2 
This changes a specified number of occurrences of a 13 
specified string to a replacement string. i4 
5 
change text=ti (€with=t3] [number=n)] [tines=tif..'2]] funit] e¢ ® 
Tyveto] i? 
| 8 
text 1 t¢ This specifies the text string which is to be 19 
replaced on lines in the range given below. 118 
. if 
with tow ot This specifies the text string which wil! 12 
replace the one searched for in the previous parameter. 13 
If this parameter is omitted the original text string 14 
will be deteted. | 15 
16 
number f! n 3 This specifies the maximum number of 17 
occurences of the original string trat are to be 118 
replaced. The value of this parameter may be given as a 119 
number or the keyword ALL. This defaults to ALL if a 128 
range is given expticit!ty for the lines parameter and to 721 
4 occurence when it is note 22 
23 
lines ! ! 3 This specifies the range of fines to be 124 
scanned for string substitution. The vatue of 1 may be 325 
given as a iine identifier or one of the keywords ALL, 126 
FIRST, CURRENT or LAST. The vatue of {2 may be given as 127 
aiine identifier or the keyword CURRENT or LAST. If 128 
this parameter is omitted ti and !2 are given the default i293 
values of CURRENT and LAST respectively. 30 
3f 
unit ! un 2 See description of unit above. 132 
33 
veto ? v 3: See description of veto above. Aiso for this 3% 
command, should the string to be replaced occur more than 35 
once in a tine, the veto option will cause the tine to be 36 
displayed once for each potential! repiacement with the 37 
next reptacement in effect. 38 
39 
Example: change *Bilt* "*Sam* t=deckae153.eLAST 149 
4&1 
The command above witli replace every occurence of the text 742 
String "°Bili°® with the text string “Sam® on each line in the 143 
deck currentiy being edited from the tine with the identifier 744 
deckaei53 to the tast active tine in the deck. 745 
46 
47 
&8 
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Se2e2 CLEARTAB ! CTAB 
This clears tabbing selections defined by a TAB command. 
cicartat {Tcolumns=c1,c2ee.cn]} 
columns i col 3 This parameter is a fist of tab columns 


to be cleared. If this pafameter is not given, ait 
columns are cleared. 


5e2eS COPY 


This copies a group of tines from an tibrary to a tocal. 


file. Tne copied lines are ieft unattered in the originat 
iocation. 


copy [text=t1il.-.f231 Tfiie=(<tocai_file_name> 
{,srewindirenind_beforetrewind_afterino_rewind]) 1] .. 
Ctines=11f.292]3 €number=n] Cunitl 


text ¢ +t 3 This specifies strings of text occurring in 
the first and tast tines of text to be copied. If this 
parameter is omitted entiretys the tines parameter wiitt 
determine the tines to be copied. It a singte text 
string is givens 2e& group to be copied wilt contain a 
Singie tine. When two text strings are given, the search 
for the second starts immediately after the occurrence of 
the first. 


fiie 1 f 3? This is the name of a ftocai file to which the 
text of the setected fines wiil be written. If this 
parameter is omitted the text lines will be written to a 
file named MERGE. The keywords below can be used as the 
second vatue of a vatue set for this parameter. 


rewind ! r 1 rewind _before i rb { rewind_after % ra 
3 no_rewind % nr 3 

This parameter specifies positioning for the focal 
file. Omission causes the file to be rewound before 
it is written. 


number in : This srecifies the maximum number of groups 
of fines to be copied. Number specifies the count of 
occurrences of the copied biock when the text parameter 
is given and individual lines when it is note This 
parameter may have its vatue given as a number or the 
keyword AiL. This parameter defaults to ALL when a range 
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is given expticitiy for the lines parameter and to 1 when 
it is not. 


fines 1! t 3 This specifies a range of iines to be scanned 
for copying. !1 can be a tine identifier or the keyword 
ALL, FIRST, CURRENT or LAST. 12 may be given as a fine 
identifier or tne keyword CURRENT or LAST. The default 
vatues supptiied if no range is given explicitty for the 
lines oarameter are CURRENT and LAST respectively. 


unit 7 oun : See description of unit above. 
Example? copy I=abce4e.eabdc.63 


In tnis example the text lines abc.4 through abc.63 will be 
copied out to a fiie calied MERGE. 


5e2e% DECK 


This command names the deck to which the following edit 
commands are to appiy. 


deck name=deck_ nametfirstinextilast 


name } nai first { next ? tast : When the keyxnord NAME 
or NA is used or a vaiue oniy is given this specifies the 
name of the deck to be edited. Tne aiternative keywords 
FIRST, NEXT and LAST can be used to setect the decks 
which occur in those nositions in the directory on the 
fibrarye 


Exampies: deck dsd 


Ge2e5 DELETE ? D 
This detetes specified tines from the current deck. 


detete [text=titeet2]] [number=n] [lines=11f-.412]] [unit] oe. 
{veto} 


text ft t 2 This specifies strings of text occurring in 
the first and iast lines of text to be deteted. [f this 
parameter is omitted entirely, the lines parameter wilt 
determine the tines to be deieted. If a singie text 
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string is given, a group to be deteted will contain a 
Singie finee When two text strings are givens the search 
for the second starts immediately after the occurrence of 
the first. 


number $n? This specifies the maximum number of graups 
of tines to be deteted. Number specifies the count of 
occurrences of matching biocks when the text parameter is 
given and individual tines when it Is note This 
parameter may have its vatue given as a number or _ the 
Keyword ALL. This parameter defaults to ALL when a range 


DON nue awe 


is given explicitly for the tines parameter and to i when 


it is note 


lines i t 3 This specifies a range of 


fines to be scanned 


for deteting. {ican be a tine identifier or the keyword — 
AlL,s FIRST, CURRENT or LAST. 2 may be given as a iine 


identifier or the keyword CURRENT or LAST. 
vaiues supplied if neo range is given a 


resovectively. 


unit to oun 2? See description of unit above. 


veto i v 3: See description of veto above. 


The defauit 


re CURRENT and LAST 


Examples: detete *This tine has a four fetter word." t=all 


d 


The first example detetes ati tines in 


which contain the indicated string. 
detetes tne current tine. 


5e2e6 DISPLAY_EBITOR_STATUS : DES 


This command displays the name of the 


current deck 


second exemple 


being edited, 


the modification name in use, the deck being edited, the 


currentiy setected width, the current 


character and 


columns, «hat window cotumns are in effect and whether the 


verify and state options are active. 


disptay_editor status 
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Se2ef END 


This command terminates the tine editor. 


Se2e8 FIND 1 F 


This finds a specified block of text in the current deck 
and updates the current position within the decke If the 
verify option is selected the first and tast tines in the 
biock will be disotayed or the tine will be dispiayed if a 
Single line is soughte 


find [(text=tif..t211] fLoccurrence=o0]}] [{iines=ii1f..1211 Cunit) 


text i ¢t 3: This specifies strings of text occurring in 
the first and tast tines of the block of text to be 
found. If this parameter is omitted entirely, the fines 
parameter witt determine the tine to be found. If a 
Singie text string is givens the block to be found wilt 
contain a singte line. When two text strings are csciveng 
the search for the second starts immediateiy after the 
occurrence of the first. 


occurrence ! oo 3 Gccurrence specifies the count of. 


occurrences of the matching block when the text parameter 
is given and single tines when it is note Occurrence 
specifies that fhe oth occurrence of the tine or block is 
to be founde The vaitue of this parameter may be given as 
a number or the keyword LAST. The vaiue of this 
parameter defauits to tle When o is negative, the oth 
previous occurence of the tine or biock wilit be found 
starting with I1 from the tines parameter and scanning 
towards FIRST. 


tines 2 1 3 This specifies a range of tines to be scanned 
for the find. {1 may be given as a tine identifier or 
the keyword ALL, FIRST, CURRENT or LAST. 12 may be civen 


as a tine identifier or the keyword CURRENT or LAST. 144 


defaults to CURRENT and {2 defaults to LAST if the tines 
parameter is omitted entirely. If the vaiue of the 
occurrence paramefer is negatives 12 may not be given and 
the search is backwards from 11 to FIRST. 


unit 2? un * See description of unit above. 


Example: f *titte* <1 
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In this exampie the SCU editor wilt start from the current 
line and then search for the nearest previous fine - which 
inctudes the text string ‘titie*. 


5e2e9 INSERT ? I 


This command inserts text after or before the specified 
line. 


insert Cuntil=diwith=t 3ifile=<name>}] lafter=Iiibefore=1i]  .o« 
{tsingle_partitionimulti_partition] 


untii i wu? with 1 wit file ! f 3: See discussion of 
replacement text above. 


after ? af ! before ! be 3: This specifies the tine . text 
is to be inserted after or before. This parameter may 
have its vaiue given as a fine identifier or one of the 
keyword FIRST, CURRENT or LAST. The default value for 
this parameter is after CURRENT. 


Singte_oartition ! so $ mutti_partition %: mp : This 
parameter is onty meaningful when the FILE keyword is 
‘used to indicate the source of replacement text. If the 
MULTI_LPARTITION keyword is inctuded on this command, each 
end of record encountered in the merge file will be 
represented on the source tibrary as a *WEOP text 
embedded directive. If the SINGLE PARTITION keyword is 
used or this parameter is omitted entirely. only the text 
before the first separator on the source file wili be 
represented on the source iibrary. 


Exampte 18 insert af=bilt.14 
This tine is inserted after bili tine 14./ 


Example 2: i ‘*{B8rief inane comment.}* 


In this example the reptacement texf was given on fhe 
commande 
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5.2.10 LIST IL 


This tists specified blocks of fines from the current 
deck. , 


Vist (text=t1f..t21] Tnumber=n] (Ctines=t1i0..121]1] Cunit) 


text 1 ¢ 3? This specifies strings of text occurring ir 
the first and tast tines of the biock of text to be 
fisted. If this parameter is omitted entirety, the tines 
parameter wili determine the tines to be tisted. If a 
Singte text string is given, the block to be listed wil! 
contain a single tine. When two text strings are given, 
the search for the second starts immediatety after the 
occurrence of the first. 


number { n 2? This specifies the maximum number of groups 
of fines to be fisteds Number specifies the count of 
matching biocks when the text parameter is given = and 
individual tines when it is not. This parameter may have 
its value given at a number or the keyword ALL.» This 
parameter defaults to ALL when a range is given by the 
lines parameter and to 1 when no range is given. 


fines 1 ¢ % This specifies the range cf fines to be 
fisted. <A vatue for 14 may be given as a line identifier 
or one of the keywords ALL, FIRST, CURRENT or LAST. A 
value for §2 may be given as a tine identifier or the 
keyword CURRENT or LAST. If this parameter is omitted, 
i114 defaults to CURRENT and 12 defaults tc LAST. 


unit t un 2 See descriotion of unit above. 
Examotes 1 n=4& 
This tists 4& tines starting with the current line. 
522011 MASK 
This command defines a character which wit! be considered 
as matching any character during string searches or clears the 
selection of such a character. 
mask charactfer=ciof f 
character ic i off 2: If the OFF keyword is used» masking 
wilt be turned off. If the CHARACTER keyword Is used or 


no keyword is used» this must be a one character string 
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specifying the character which is to be used to match ait 3 oi 
characters in string searches. : 2 

3 

Exampie? Mask **°* | 14 
change “*P*¥rr*t*n* *Perreten* i 5 

6 

-In this exampte alt vowels in the name Perreten are e"ss« if 
These commands will correct all misspellings cf the name in : 8 
the current deck which match the pattern civen by the TEXT 13 
parameter. 710 
it 

12 

5e2e2i12 REPLACE i? R : 13 
14 

This deletes each grour of lines in the specified range 15 
that starts and ends with tines containing the specified text, 715 
and replaces each group of tines with the replacement text. i417 
18 

replace Ctext=ft1i..tZz}] Cuntii=diwith=t3ifite=<name> ji oe 119 
Inumber=n] {tines=11f..e12]]} Ctuniti {veto} ee 328 
{singte_oartitiontmulti_partition! {21 
22 

text ? ¢t 3: This specifies strings of text occurring in $23 

the first and tast tines of text to be repitaced. If this 728 
parameter is omitted entirely, the lines parameter wilt 725 
determine the iines to be reotaced. If a singie text 326 
string is givens a group to be replaced witi contain a 127 
Single lines. When two text strings are civen, the search 128 

for the second starts immediateiy after the occurrence of i29 

the first. 130 

3i 

until ¢ u $$ with ? wt file $ f : See discussion of :32 
reptacement text ebove. 133 

| 3%& 

number { n : This specifies the maximum number of groups i135 

of tines to be reptaced. Number specifies the count of 136 
matching blocks when the text parameter is given = and 13% 
individual lines when it is not. This parameter may have 138 

its vatue given as a number or the keyword ALi. This 139 
parameter de fautTs to ALL when a ierange is given 748 
explicitiy for the lines parameter and to 1 when it is i&l 

note {42 

&y 

fines ! 1 3 This specifies a range of tines. to be scanned 144 

for replacement. ii1can be a tine ftdentifier or fhe 745 
keyword Ail, FIRST, CURRENT or LAST. 2 can be a fine 146 
identifier or the keyword CURRENT or LAST. The defauit 147 
values supotied if no range is given are CURRENT and 748 
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LAST. 
unit ft un 2See description of unit above. 
veto ! vy 2 See description of veto above. 


Singte_partition ? sp 3 multi partition : mp 3 This 
parameter is onty meaningful when the FILE keyword is 
used to indicate the source of reptacement text. If the 
MULTI_ PARTITION keyword is inctuded on this commands, each 
end of record encountered in the merge fife wili be 
reoresented on the source library as a *WEOP text 
embedded directive. If the SINGLE_PARTITION keyword is 
used or this parameter is omitted entirely, oniy the text 
before the first separator on the source file wil! be 
represented on the source tibrary.e 


Example: replace ‘cat! otfd* tines=ALL 
cail new(p1,.p2,03)/ 


5e2e13 SEQUENCE | SEQ 


This command atters the form in which tines from the 
fibrary are displayed by the editor. 


sequence onioffiseparate 


on i off 3} separate 2? If the ON keyword is used on this 
command, the tine identifier wilt! precede the text of the 
line on the display as part of the same linee If the OFF 
keyword is used on this command the tine identifier wit? 
not be displayed. If the SEPARATE keyword is used the 
fine identifier wili precede the text of a tine as a 
separate flinee The initial setting of this option is 
taken from the vatue of the LID fietd in the header of a 
deck when a deck is setected for editing on the EDIT call 
or a $DBDECK command. If tLID=NONE then SEQUENCE OFF is 
selected, otherwise SEQUENCE ON is setected. 


5Se2014 STATE 
This command causes the state of the modification 
associated with the introduction of a text !f!ine to be 
displayed when that tine is displayed. 


state onioff 
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Se2215 TAB ? T { 
2 

This command aiters the tabbing environment for the 13 

INSERT and REPLACE commands. The user specifies a tab ; & 
character and coiumns. The presence of the tab character i 5 

in input text causes blank fill to the next tab cofumn. :; 6 

Tab characters entered after the tast tab column has been 17 
reached wilt be accepted as datae use of the DECK 3; 38 
command causes the default tab selections for the named : 9 

deck to be invoked. . 319 

oe © § 

tab [character=c] (columns=c1,ct2,5.0e.Cn]} 112 

13 

character 1c 3 This one character string specifies 74% 

the tab character. If this poarameter is omitteds 715 

the currentiy selected tab character wili remain in 116 

effect. 117 

18 

columns { cot : This gives tab «columns te be 719 

selected. A maximum of 256 tab coflumns may be 128 

selected at any timee These integers must be in the 2i 

range i to 2562 Muitipie columns may be specified 122 

aS a vatue tist (see the Parameter Lists section of i23 

the NOS/VE ERS). If this parameter is omitted $246 

entirety the currentiy selected tab columns w«ailtl 125 

remain in ef fecte 126 

2? 

Exampie?: tab °“\"* (11,18,30,36) 28 
29 

36 

5e2016 VERIFY 3 V 3i 
| 32 

This command causes the CHANGE command to echo back to the 733 
user the altered line (s). In addition if the verify option is 13% 
selected the first and tast tines of a bdbfock ftocated by the 335 
FIND command wil! be displayed or the tine witt be disptayed $36 
if a singte !tine is sought. 137 
38 

verify onio ff 39 
&G 

. 4&1 

5e2.17 WIDTH ? W 742 
4&3 

This command deciares the number of characters the editor 145 
will allow to be entered in a text tine without issuing a © 945 
warning message. Use of the DECK command causes the default 146 
width from the deck header to be invoked. 14? 
48 
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SCu EDITOR 
217 WIDTH ¢{ WwW 
width width=n 
width iow: The vatue for this parameter must be given as 


an integer from 6 te 256. Specifying 0 will atiow tines 
of up to 256 characters to be entered. 


502218 WINDOW ¢$ WN 


This command timits the range of character positions within 


a tine to be scanned in string searches during subsequent 
editor commandse Onity the characters in the given range are 


searched for a match with the string given on the commands 


DELETE, LIST, REPLACE, FIND, COPY and CHANGE. 
window (columns=cile.c2}]} 


columns i col % This specifies the starting and ending 


“scan columns. ci defaults to column 1 and c2 to column. 


2566 
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Se3 EDITOR. FUNCTIONS 


Specialized command tanguage functions will be availiable 
within the version of the SCU editor which executes under 
NOS/VE. They are intended to be used in conjunction with the 
System Command tanguage controi statements to aid in attering 
the path taken through sequences of ‘SCU editor commands. 
These functions wil! not be avaitabte in the NOS 170 version. 


Se321 SCURRENT_DECK 

This function wilt! return the name of the currentiy 
selected deck as its velue. 
50322 SFIRST_DECK 

This function will return the name of the ceck which occurs 
first in the directory of the tibrary as its value. 
523-3 SLAST_DECK 

This function witi return the name of the ceck which occurs 
tast in the directory of the library as its vatue.e 
Se4 EDITOR LOOPING 

On NOS/SVE it witi be possibie to combine SCU editor 
commands and functions with SCL control statements to perform 


repetitive changes that are often necssary in such 
applications as test base maintenancee 
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6.0 FEATURES UNDER CONSIDERATION 
The features iisted in This section are under 


consideratione Some are tisted here because if is felt that 


they may prove superfluouse In other cases they are tisted 
here because it is questionabite whether they are compatibie 
with the basic design of the utitity or it is not yet clear in 
what form the feature should be supplied. : 


6.1 MODNAME EDITOR COMMAND 


It may prove desirabfe to provide a editor command similar 
to the MODNAME directive in MODIFY, which would establish a4 
defauit modification name allowing a shorthand form for tine 
identifiers. 


6e2 [NACTIVE LINES ANDO THE EDTTOR 


Currentiy it is olanned that the SCU editor dealt with onty 
active tines. It may prove desirable for the editor to FIND 
or LIST inactive tines or perform other manipulations on 
inactive tines. 


6e3 RESTORE LINE COMMAND 


It may prove desirable to provide a RESTORE command in the 
editor, which would clear the inactive flag for tines 
previousty deletede 


6.4% CHANGES NOT INTRODUCED IN THE EDITOR 


Some SCU commands outside the editor introduce significant 
changes to a source tibrary without being associated with a 
modification name. to effective method for automatins the 
controt of this type of change has been devised. Those 
conmands of concern in this respect are PURGE_CECK, 
SEQUENCE_DECKs PURGE_MODIFICATION and SEQUENCE _ MODIFICATION. 
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605 AUTOMATIC MODIFICATION RESEQUENCING 
It may be desirable to automaticatty resequence 


modifications when their state is raised to : a 
(developmental). See the SEQUENCE MODIFICATION commande 


606 SAVING EDTT FILES 


It may be desirabie to provide a mechanism for poreserving 
an library as permanent without exiting the editore 


607 KEY CHARACTER SUBSTITUTION 


It may be desirabte toc affonw the CHANGE _ LIBRARY command to 
substitute the key character used on a source tibrary. 


6.8 COMPARE UTILITY 
It may prove useful to supply a utility which could compare 
a source file wifh a deck on an SCU iibrary and produce a set 


of editor commands to cause the deck to match the source 
filee 


6.9 PROCESSOR BASED DECK SELECTION 

Tt may orove useful to provide 4a capabitity to 
conditionatty write a deck to an expanded text file based on 
the contents of the processor fieid in the deck header. 
6e10 EDITOR MOVE COMMA tD 


It may prove useful fo provide an editor command to move a 
biock of text lines from one place in a deck to another. 
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7-0 PHASED IMPLEMENTATION 


Current plans are to imptement tne version of SCU that 
executes under NOS 170 in the steps below. Design of the 
version of SCU to execute on NOS/VE has begun and 
implementation witt tentatively begin in March of 1980. 


1. Att SCU features wilt be implemented and tested by 
the project by Arriit,1980. 


 2e SCU will be ready for reiease as part of the SES 


toots package, as part of SES Release 1&, currentiy 
scheduled for July, 1980. 
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8.1 NON-EOTTOR MESSAGES 


Beiow are listed messages issued orimarity from non-editor 
SCU procedures. The conditon numbers are shown retative to 
9000. This origin may change on 170 and wilt chance on 
NOS/VE. The fetters tisted in tne severity cotumn stand for & 
- error, F -- fatale I - informative and WwW - warning 
respectively. Where the characters +#T are shown below some 
string will be substituted in the actual message. 


Condition eevee Message 
9001 file #¥ not tocal 


9002 E file #+T is not SCU library 


Tne contents of the file #+T are not recognizabie by the 
utility as an SCU source tibrary.e 


9003 E emoty SCU fibrary - +T 


There are no decks on the SCU library on file +T. 


9004 E deck #T not found 
9005 E mod #+T not found 
9006 confiict in file name - #T 


An Exampte of when this message is issued is namine the 
same fite for two different parameters on a command such as 
EXM MODNAME BA=FILE EC=FILE. The message will aiso be issued 
if the user attemots an operation fhat woutd be destructive to 
the resuit file named on the SCU.GROUP commana. 


3007 E duplicate deck name - +f 


The user has mentioned the same deck twice on the same 
‘command. 


9008 E dupticate mod name - +#T 
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The user has attempted to create a modification «ith the 
Same name as one already existing on the source library. 


9009 E deck #T already on tibrary 


The user has attempted to create a deck with the same name 
as one already existine on the source ltibrary. 


9016 . E emoty deck - #T 

No text fines have ever been introduced into deck +T. 
9011 E invalid deck range - #T to +#T 

One of the deck names siven as one of the ends of ae range 
does not exist on the tibrary or they are not in order of 
occurrence on the fibrary. 
9012 E invatid mod range - +T to +T 

One of the modification names given as one of the ends of a 
range does not exist on the tibrary or they are not in order 
of occurrence on the tibrary. Disptaying the modification 
tist for the tibrary should suggest whiche , 
9013 E invatid parameter vaiue for +T 


An invatid vatue has bdeen given for parameter #Tf on the 
command or directive currenttiy being scanned. 


9014 -£ unexpected tT encountered 

+T 1s an unexpected text embedded directive (ELSE, IFEND or 
TEXTEND) which has been encountered in the text of the deck 
currenttiy being processed. 


9015 E expected #+T not found 


SCU has searched to the end of a deck wifhout encountering 
a matching text embedded directive (IFEND or TEXTEND). 


9016 E user without proper authority 
The user has attempted to oerform some commmand which is 


restricted to one of the user names assigned authority for the 
tibrary. . 
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8.1 NON-EDITOR MESSAGES 
9017 E deck #+T already interlocked it 
2 
9018 — iltegal directive +T 12 
& 
The expression given on the displayed *IF text embedded + 
directive is not recognizabte. 16 
; ¥ 
9019 E too many nested IF"*s 7 8 
9 
The user has nested his IF directives beyond the depth 318 
currentiy processed by SCU (32). 111 
i2 
9028 E too many alternate bases ; 113 
18 
SCU currentiy allows the specification of at most 128 115 
libraries on those commands that alttow multipie libraries. 16 
1? 
99214 E 4T value too large 118 
193 
+T is the keyword for the parameter which was given a vatue $20 
too ftarge. i2ft 
: 22 
9022 £ mod #T not state 4 723 
24 
9023 E mod +T state 4& 725 
| 26 
9024 € +T i27 
28 
In the case of this message the entire error message is 129 
substituted and should exptain itsetf. 138 
31 
9025 E file +T¥ without write cermission 132 
33 
9026 £ grouping commands. BASE specified, 136 
RESULT must be specified. 335 
36 
9027 E feature #T not found 132 
38 
9028 E group #+T not found 139 
&Q 
9029 E different key character on fite - +T 141 
42 
9030 I fine +T in deck tT truncated 743 
4G 
The indicated line in the indicated deck was truncated on 145 
an EXPAND_DECK or EXTRACT_DECK command. A targer width witt 746 
have to be supotied on the command or the line will have to be 147 
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; i 
9031 E intertock violation in deck +#T 3 2 
3 
An intertock violation has occurred for the indicated deck 1 & 
during the processing of a COMBINE_LIBRARY or REPLACE_LIBRARY 7 5 
command. 16 
7 
9090 F unabie to allocate +T ; 8 
9 
*#T refers to tabies aitocated in memory such as 718 
P_mod_names, used for the tist of modificaticn names apotlying $11 
to a deck. Short of restructuring his tibraries there is #22 
iittie tne user can do to correct this probien. $13 
14 
9099 F internal error +#T 115 
16 
SCU nas detected an internal error explained in the text of $17 
+T. An example might be a tftibrary pointer out cf range. 318 
There is no remedial action available to the user beyond 119 
submitting a PSR documenting the probfem so that the § faiture 126 
wherever it may be can be sought out and corrected. 3214 
22 
23 
26 
8.2 EDITOR MESSAGES 125 
26 
Below are tisted the messages issued by the SCU editor {27 
procedures. The condition numbers are shown retative to. 128 
8000. This origin may change on NOS 170 and will change on 729 
NOS/VE. The tetters given in the severity column have the 338 
foltoning siagqnifcance E - error, F - fatai, I - informative i3f 
and W =- warning. The characters +T will be reptaced with 132 
other text in the actual messages. 233 
3% 
Condition. eames Message 335 
8001 Unknown command: +¢T 238 
3F 
The string of characters +T was not recognizabie as an SCU 138 
editor command. 139 
& 0 
8002 E No deck active os i 
42 
The user thas not indicated to which deck on the tibrary 143 
editor commands are to apoly. 14% 
4S 
8003 E Base and result fiies must be different 145 
files 14% 
&8 
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8004 E Continue specified for unknown 


modification +T 


The user has specified continue on the editor cal! command 
and the modification +T does not exist on the iibrary. 
Issuing a DISPLAY_MODIFICATION_LIST command for the tibrary 
may point out a misspelling. ) 


8005 E Duviicate modification name +T 

The user has called the editor naming a modification name 
which atready exists on the library without specifyins the 
CONTINUE keyword. He must either choose a different 
modification name or. specify the keyword CONTINUE to add to 
the named modification. 
8006 E Modification +f not in state 0 


SCU does not allow modfications in states other than 0 to 
be changed. 


8007 E Invalid Modification name 
8008 E Invalid keyword vaiue for NUMBER - 4T 


Tne onty vaiid keyword value for the number parameter is. 
ALL or A. 


8009 E . Vaivue for NUMBER must be positive 
integer or keyword 

8010 E Invatid fite name 

8011 E Invalid fiie position specified 


Vaitid keywords for fite positioning are REWIND or Ry 
REWIND BEFORE or RB» REWIND_LAFTER or RA and NO_LREWIND or NR. 


8012 £ Column number too targe 


Yaiues for the COLUMNS parameter must be between 1 and 
2566 


8013 E Width greater than maximum tine tength 
Vatues for width must be between 0 and 256. 
8014 E€ Width greater than maximum width for 
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deck { ft 
2 
The user has attempted to give avaiue for width greater : 3 
than that in the deck header on the iibrary. 1 & 
| 5 
8015 E Modification name +T tco tong 7.8 
8016 £ Line identifier mus t start with : 8 
modification name 7 9 
19 
8017 E Sequence number too targe 112 
. 12 
The ftargest vatue SCU aliows for a sequence number is $13 
262143. 11% 
i5 
8018 E Sequence number required after 316 
. modification name 117 © 
18 
8019 E Invatid keyword vatue +f 719 
An invatid keyword value has been given for the LINES or 12t 
AFTER/BEFORE parameter. 122 
23 
BD21 a Keyword ALL cannot be used in a range 124 
. 25 
8022 E Range of tines cannot be specified for 126 
a backward search 127 
28 
8023 E Unknown modification name +4T 129 
38 
The SCU editor does not recognize +T as the name of a 732 
modifcation on the tibrary. $32 
33 
8024 E Line at end of range is inactive 134 
35 
The editor operates on active tines oniy. 136 
37 
8025 £ Last tine in range not found after 138 
first tine 339 
&0 
8027 E First iine in range not found before 147 
last tine 142 
43 
8028 E First tine in range not found 148 
&5S 
8029 £ First tine in range not active $486 
sf 
The editor operates on active tines onty. 348 
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8030 E Text string #T not found 
8031 I +#T occurrences found 

This message informs the user how many occurrences of a 
text block were found if the user asked to find ali or some 
number greater than existed in. the range of tines to be 
searched. 
8032 E No active jiines in rance 

The editor operates on active tines onty. 
8033 I +T lines to end of range 

This message informs the user how many tines were found in 
the remainder of the range of tines to be accessed if the user 
asked to operate on aii tines or some number greater § than 
exist in the remainder of the range. 


803% W | Line is tonger than maximum tine tength 


One of the tines the user has introduced was greater than 
256 characters in length. It has been truncated toc 256 


characters. 
8035 I Begin editing deck +T 
8036 E No start of deck 


Tne structure of the ftibrary is not intact. There is no 
remediai action availabte to the user. 


8037 E History array for iine has overfi owed 


The tine in question has been modified more than 255 
times. 


8038 W Line is ftonger than current tine width 
This is a warning that the user has introduced ae tine 
ftonger than the current t!iine width and should consider 
splitting the tine where appropriate. 
8039 E Invalid keyword value for occurrence = 
+7 


COMPANY PRIVATE 


SSM A MS Gh rH 


5-8 
COC SOFTWARE ENGINEERING SYSTEM 
: 03/24/80 
ERS for Source Code utility {NOS 176 Version) REV? J 
8.0 MESSAGES 
Be2 EDITOR MESSAGES 


The onty acceptabie keyword vatue for the OCCURRENCE 
parameter is LAST or Ll. 


8040 ae Value for occurrence must be integer or 
keyword 
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9.0 SUGGESTIONS ON SCU USE 


The degree of control necessary over corrections to source 
data blocks being maintained for an individual for his own 
convenience and over the source code for a major operating 
system component being maintained by an integration and 
evatuation group is very different. For that reason the tuo 
groups of suggestions are offered below. 


921 PRIVATE SOURCE CODE MAINTENANCE 


For the convenience of an individual maintaining a orivate 
‘source tibdrary if is suggested that he set ail authorities to 
his own user name. Probably the onty criteria fite directive 
that he would need to use would be DECLARE, which is useful in 
allowing aiternate btocks of source code to be written te an 
expanded text fiie. 


Ge2 GROUP SOURCE CODE MAINTENANCE 


It is suggested that for maintenance of compiex biocks of 
source data that may be required to be accessibie to a éetarge 
group of imptementors that the authority and intertock 
features of SCU be used to ensure contro! over modifications 
being madee It is suggested that a user who is assigned the 
responsibility to imptement a correction to a particular deck 
extract a subset tibrary containing onty the deck that he is 
to modifys, setting the interlock for that deck in the 
process. 


The individual coufd then enter his correction and make 
trial use of it from his subset source tibrary satisfying 
needs for ofther decks from the base tibrary specified as an 
aiternate. The individual would finally submit his modified 
subset tibrary for code review and combining with the base 
tibrary with the new corrections in state O-« The intertock 
would be cleared when the combine was donee 


As various stages of testing are compteted the persen in 
authority can grant that the new corrections be raised in 
state or if testing indicates that the correction is not 
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acceptable can tower the state of the correction to state @ 
and contact the person responsibie to make an adjustment 
before resubmitting the correction. 


Expanded text fites can be built with att avaitable 
corrections on the base source library to check for conflicts 
between developers or at the other extreme can be built with 
oniy reteased code to produce a version of the source data at 
some significant milestone. 


The DISPLAY_LIBRARY, DISPLAY_DECK, DISPLAY _MODIFICATION, 
DISPLAY_GROUP and similar commands can be used to helio 
document and evatuate subset source tibraries orior to 
combining them with the base source tibrary. 


Criteria fiites can te used to specify the contents of a 


complex expanded text file. The contents of these fiies can 
of course be maintained on the source iibrary themselves. 
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